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Third Party Systems 


The software is designed to run in an environment containing third party elements meeting certain prerequisites. These 
may include operating systems, directory services, databases, and other components or technologies. See the 
accompanying prerequisites list for details. 


The software may require a minimum version of these elements in order to function. Further, these elements may require 
appropriate configuration and resources such as computing, memory, storage, or bandwidth in order for the software to be 
able to perform in a way that meets the customer requirements. The download, installation, performance, upgrade, 
backup, troubleshooting, and management of these elements is the responsibility of the customer using the third party 
vendor's documentation and guidance. 


Third party systems emulating any these elements must fully adhere to and support the appropriate APIs, standards, and 
protocols in order for the software to function. Support of the software in conjunction with such emulating third party 
elements is determined on a case-by-case basis and may change at any time. 
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About This Manual 


This administration guide is written to provide network administrators the conceptual and 
procedural information for administering Micro Focus File Reporter. 

+ Chapter 1, “What's New,” on page 9 

+ Chapter 2, “Overview,” on page 11 

+ Chapter 3, “The Administrative Interface,” on page 23 

+ Chapter 4, “Performing Setup Procedures,” on page 29 

+ Chapter 5, “Scheduling and Performing File System Scans,” on page 35 

+ Chapter 6, “Generating File System Reports,” on page 51 

+ Chapter 7, “Content Scanning and Reporting,” on page 107 

+ Chapter 8, “Performing Other Administrative Tasks,” on page 117 

+ Chapter 9, “Using the Report Viewer,” on page 123 

+ Chapter 10, “Using the Data Analytics Tools,” on page 127 

+ Chapter 11, “Using Report Designer,” on page 137 

+ Appendix A, “Filtering for Built-in Reports,” on page 155 

+ Appendix B, “Security Settings,” on page 161 

+ Appendix C, “Log File Locations,” on page 165 

+ Appendix D, “AgentFS Scan Capabilities,” on page 167 

+ Appendix E, “Glossary,” on page 171 


Audience 


This guide is intended for network administrators who manage network storage resources. 


Feedback 


We want to hear your comments and suggestions about this guide and the other documentation 
included with this product. Please use the User Comment feature at the bottom of each page of the 
online documentation, or go to www.novell.com/documentation/feedback.html and enter your 
comments there. 


Documentation Updates 


For the most recent version of the Micro Focus File Reporter 4.0 Administration Guide, visit the 
Micro Focus File Reporter Documentation website. 
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Additional Documentation 


For additional File Reporter 4.0 documentation, see the following guides at the Micro Focus File 
Reporter Documentation website: 


+ Micro Focus File Reporter 4.0 Installation Guide 


+ Micro Focus File Reporter 4.0 Database Schema and Custom Queries Guide 


About This Manual 


1.1 


What's New 


With each product update, Micro Focus File Reporter introduces significant architectural and feature 
enhancements. 


New in Version 4.0 


Reporting for Microsoft 365 


File Reporter is now enabled to scan Microsoft 365 cloud repositories for data and associated 
permissions for OneDrive for Business, SharePoint Online, and Teams. 


Advanced Duplicate File Detection 


A new scanning option allows for Agents to produce a content-based hash for specific files for 
complete duplicate detection and aggregate reporting. New packaged Custom Query reports can 
then generate a report of duplicate files based on hash comparisons. 


Pre-built Custom Queries and Report Layouts 


For reporting on files and permissions in the Microsoft 365 cloud, File Reporter includes pre-built 
custom queries and report layouts that you can utilize. 


Reporting Exclusive to the Microsoft Network and 365 Cloud Platforms 


Previous versions of File Reporter reported on both Microsoft and Micro Focus Open Enterprise 
Server (OES) platforms. While the release of File Reporter 4.0 discontinues this multi-platform 
reporting, File Reporter continues to provide OES reporting through File Reporter 3.6. File Reporter 
customers have entitlements to both product versions. Micro Focus will continue to support OES 
and eDirectory through the File Reporter 3.x product line. 
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10 What's New 


2.1 


2.2 


Overview 


This section provides an understanding of Micro Focus File Reporter, the supported databases, the 
Engine, and Agents, along with how reports and analytics information are generated. 


¢ Section 2.1, “Micro Focus File Reporter,” on page 11 


+ Section 2.2, “How File Reporter Works,” on page 11 


Micro Focus File Reporter 


Micro Focus File Reporter inventories Microsoft network file systems and Microsoft 365 cloud 
storage to deliver the detailed file storage intelligence you need to optimize and secure your 
network and Microsoft 365 cloud for efficiency and compliance. Engineered for enterprise system 
reporting, File Reporter gathers data across the millions of files and folders scattered among the 
various network storage devices and OneDrive for Business, SharePoint Online, and Teams cloud 
storage areas that make up your network and cloud storage. Flexible reporting, filtering, and 
querying options then present the exact findings you need so you can demonstrate compliance or 
take corrective action. 


File Reporter identifies files currently stored, the size of the files, whether these files contain 
personal or other sensitive information, when users last accessed or modified the files, the locations 
of duplicate files, and more. File Reporter can also help you calculate department or individual 
storage costs. File Reporter can even identify access rights to folders and consequently, the files that 
are contained within. 


How File Reporter Works 


+ Section 2.2.1, “Core Components,” on page 12 

+ Section 2.2.2, “File System Scanning,” on page 13 

+ Section 2.2.3, “File Content Scanning,” on page 14 

+ Section 2.2.4, “Microsoft 365 Cloud Scanning,” on page 15 

+ Section 2.2.5, “Reporting,” on page 15 

¢ Section 2.2.6, “Client Tools,” on page 18 
File Reporter was developed to examine, report and analyze Windows file systems and the Microsoft 
365 cloud and its potential petabytes of data—in other words, millions of files, folders and shares, 
scattered among the various storage devices and Microsoft 365 applications that make up your 


network. This reporting includes file content and the associated rights of these files, folders, and 
network shares. 


To examine, report, and analyze this data efficiently, File Reporter disperses the work among a Web 
application, Engine, Agents, a Scan Processor, the RabbitMQ messaging broker, either a PostgreSQL 
or Microsoft SQL Server database, Microsoft Active Directory, and Microsoft Azure Active Directory. 
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Figure 2-1 File Reporter Work Process 
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2.2.1 Core Components 


The following are core components of Micro Focus File Reporter. 


Web Application 


The Web application runs on top of Microsoft Internet Information Services (IIS) and is the means of 
all administrative interaction. Among other things, the Web application is responsible for: 


+ Management of scan policies and report definitions 
+ Generating Preview reports 
+ Access to stored reports 


+ All other management functions 


Engine 


The Engine is the mechanism that runs File Reporter and runs from a Windows Server host. The 
Engine does the following: 


+ Schedules the scans that the Agents conduct 


+ Compiles scans for inclusion in a report 


+ 


Runs scheduled reports 


+ 


Manages scan delegations to Agents 


+ 


Sends notifications that File Reporter has completed a scan or generated a report 
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Database 
The database stores information needed for generating reports. This information includes: 


+ Cached Active Directory objects 

+ Scans 

¢ Identity system information such as names of Active Directory domains and forests 
+ Schedule information pertaining to scans and reports 

¢ Notification information 

+ Report definitions 

+ Scan history 

+ Scan policies 


+ Free space on shares 


2.2.2 File System Scanning 


The following are components associated with file system scanning. 


Scan Processor 


The Scan Processor does the following: 


+ Processes file system scan files 


+ Updates file system scan information in the database 


Agents 


Agents are compact programs that run on Microsoft Windows Server hosts. Agents can examine and 
report on NTFS file systems and OneDrive for Business, SharePoint Online, and Teams files stored in 
the Microsoft 365 cloud. Additionally, Agents examine and report on security, including file and 

folder permissions. For more information, see Appendix D, “AgentFS Scan Capabilities,” on page 167. 


IMPORTANT: For optimal results, you should install an Agent on every server that has a share you 
want to report on. 


Agents cannot be installed on NAS devices or clustered storage. For File Reporter to report on these 
type of devices, Agents can be set up as proxy agents. 


For performing file system scans (rather than file content scans), File Reporter provides AgentFS. 
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2.2.3 


Scans 


Through AgentFS, File Reporter scans a storage resource. A storage resource can be a Microsoft 
network share or a Network Attached Storage (NAS) device. 


File system scans are indexed data that are specific to a storage resource. They are the means of 
generating a storage report or the means of analyzing data using the analytics tools. File system 
scans include comprehensive information on the file types users are storing, when files were 
created, when they were last modified, permission data on the folders where these files reside, and 
much more. 


File Reporter collects file system scans from the Agents and sends them to the Engine. The Engine 
then sends the scans to the Scan Processor, which stores the scans in the database. 


You can conduct scans at any time, but we recommend using a scheduled time after normal business 
hours to minimize the effect on network performance. 


NOTE: Procedures for performing scans are documented in Chapter 5, “Scheduling and Performing 
File System Scans,” on page 35. 


File Content Scanning 


The following are components associated with file content scanning. 


ManagerFC 


The ManagerFC service is responsible for the execution and management of file scan jobs. The 
service performs the following tasks when processing a scan job: 


+ Enumeration of files in target paths 
+ Submission of files to scan queues in the message broker based on filter criteria 


+ Processing of scan results and update of result data to the database and scan result files 


AgentFC 


AgentFC performs file content scans. AgentFC is hosted on a Windows Server and performs content 
scans on files stored on Windows servers and NAS devices. 


Scans 


Through AgentFC, the RabbitMQ messaging broker, and ManagerFC, File Reporter performs, 
classifies, and categorizes file content scans. For example, content scans can identify files containing 
specified patters such as U.S. Social Security or credit card numbers. 
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2.2.4 


2.2.5 


Microsoft 365 Cloud Scanning 


With the release of version 4.0, File Reporter extends the ability to report what files are being stored 
on your enterprise storage devices and who has access to these files, to reporting on the files and 
associated permissions located in Microsoft 365 cloud repositories for OneDrive for Business, 
SharePoint Online document libraries, and Teams document libraries. 


Unlike scanning the network file system separately for File System, Permissions, and Volume Free 
Space, scans for files and associated permissions stored in the Microsoft 365 cloud are conducted 
simultaneously. 


Reporting on Microsoft 365 is done through Custom Queries and report layouts available at 
filequerycookbook.com. The process is as easy as searching through the cookbook to see what type 
of report you want to generate, downloading it, pasting the query into the File Reporter Report 
Designer Query Editor, defining any needed paths or making desired modifications, and then laying 
out the report. 


Reporting 


When File Reporter has a scan, you can utilize it to generate a report. You can generate reports 
through the following means: 


+ Built-in Reports 


+ Custom Queries 


Built-in Reports 


Generating a built-in report is as simple as selecting the report type from a menu. 


To generate a report, the Engine takes all of the needed scans that are applicable to the 
specifications of the report and consolidates them into a single report by indexing the applicable 
scans. 
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Table 2-1 Built-in Report Types 


File System Reports Security Reports Trending Reports 
Folder Summary Assigned NTFS Permissions Volume Free Space 
Detail Reports Permissions by Path 

File Extension Permissions by Identity 

Duplicate Files Historic NTFS Permissions 

Date-Age 

Owner 


Storage Cost 

Comparison 

Directory Quota 

Historic File System Comparison 


File Reporter lets you present built-in reports in various formats including PDF, Microsoft Excel, RTF, 
HTML, TXT, and CSV. The product also includes built-in graphs for certain report types. 
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Figure 2-2 Sample Report in Graphical Format 
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Custom Query Reports 


These reports allow administrators who are familiar with querying the database to generate very 
specific report data that might not be available through one of the built-in report types. 


Custom Query report data can be further customized for layout and presentation from a Windows 
workstation with the Report Designer. 


File content and Microsoft 365 reports are delivered as Custom Query reports. 
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Figure 2-3 Page from a Custom Query Report Designed with the Report Designer. 
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2.2.6 Client Tools 


File Reporter provides the following Client Tools, designed to be run from a Windows workstation. 
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Data Analytics 


In addition to extensive reporting options, File Reporter provides the ability to graphically analyze 
file system data using a variety of analytics tools that are available to administrators through the 
Client Tools. 


Dashboard 


The Dashboard lets you graphically analyze data from file system scans according to the filters that 
you specify. 


Figure 2-4 Dashboard 
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Tree Map 


The Tree Map lets you view graphical representations of hierarchical file system data and in the 
process, gain insight very quickly. 
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Figure 2-5 Tree Map 
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Figure 2-6 Pivot Grid 
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Report Viewer 


The Report Viewer lets you to view all stored reports locally from a Windows workstation. Because 


the Report Viewer utilizes the resources of the Windows workstation, rather than those of the 
Engine, the Report Viewer can display stored reports much faster in most instances. 
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Figure 2-7 Report Viewer 
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3.1 


3.2 


The Administrative Interface 


+ Section 3.1, “Supported Browsers,” on page 23 
+ Section 3.2, “Launching the Administrative Interface,” on page 23 


+ Section 3.3, “Using the Administrative Interface,” on page 25 


Supported Browsers 


Micro Focus File Reporter is managed through a Web browser-based interface and is supported on 
the latest versions of the following browsers: 


Table 3-1 Supported Browsers 


Windows Linux Mac OS X 
Firefox Firefox Firefox 
Chrome Chrome 
Edge 


Launching the Administrative Interface 


1 In the browser's address bar, type: 

https://file_reporter_web_server_dns_name 

The DNS name is the one you created in the “Micro Focus File Reporter 4.0 Installation Guide.” 
You must enter the DNS name. You cannot log in with an IP address. 


The login screen appears. 
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File Reporter 4.0 


User Account 


Password 


2 Enter the username and password of a member of the SRsAdmins group that you created and 


click Log In. 


The username can be entered in any of the standard Active Directory formats: 
domain\SAMAccountName (AD\User1) 


UPN(useri@ad.test.lab) 


LDAP (CN=user1, OU=home, DC=ad, DC=test, DC=lab) 


With LDAP, there may be partial case sensitivity, especially with the domain (DC=) components. 


The File Reporter Home page appears: 


File Reporter 4.0 


2020-11-24 16:50:20 PM 
Coordinated Universal Time 
(UTC +00:0 


The Administrative Interface 


i Seans 


File System Scan Policies 


File System Agents 
Total Agents 
File System Scans Data Path 


otal Space 
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hal Reports 


Report Definitions 
Report Generation 

Reports in Progress 

# Stored Reports 
Stored Report Storage 

Bytes In Use O bytes 


Free Bytes Remaining 34.55 GB 


3.3 Using the Administrative Interface 


¢ Section 3.3.1, “Viewing Notifications,” on page 25 
+ Section 3.3.2, “Configuring the Web Interface,” on page 26 


¢ Section 3.3.3, “Viewing System Information,” on page 27 
All tasks are conducted by selecting an option from one of the menus at the top of the page. 


The Main menu provides access to notifications and system information. The File Systems menu is 
the means to setting up and viewing the progress of file system scans. The File Content menu 
provides options for setting up and conducting file content scans. The Governance menu is for 
enabling the conducting of access reviews on unstructured data through Micro Focus Identity 
Governance. The Microsoft 365 menu provides the means of scanning OneDrive for Business, 
SharePoint Online document libraries, and Team libraries. The Reports menu is the means of 
generating and accessing reports. The Configuration menu is the means of establishing and 
modifying configuration settings within File Reporter. 


3.3.1 Viewing Notifications 


File Reporter displays notifications for successfully completed scans, failed scans, completed reports, 
failed reports, errors, warnings, and other information. You can use the filtering options to list only 
the notification types you want. 


1 From the Main menu, select Notifications. 


Notification 


Like many pages in the administrative interface, you can modify the current display. 
2 (Optional) Display columns in the order you want by dragging them to the desired location. 
3 (Optional) List the most recent notification by clicking the column heading twice. 
4 (Optional) Filter the notifications to display only the information you want: 
4a At the desired column heading, click the “pin” icon. 
For example, the Message column. 
4b Select the desired filter option. 


For example, Contains. 
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Ac In the field to the left of the “pin” icon, enter the distinguishing word or letter for the filter. 
For example, Permissions. 


The page is updated according to the filtering parameters. 


Notifications 


3.3.2 Configuring the Web Interface 


26 


After 20 minutes of inactivity in the administrative interface, you are required to log in again. You can 
adjust this setting and specify the number of items displayed per page through the Web Application 
option of the Configuration menu. 


1 From the Configuration menu, select Web Application. 


File Reporter 4.0 Main ~ File Systems ~ File Content ~ Governance ~ Microsoft 365 ~ Reports ~ Configuration ~ Ê sP\Administrator 


Web Config 
Display Options 


Grid Page Size 50 E rows Note: This setting applies to the current browser only. 


Session Options 
Authentication Timeout 1440 ` minutes Note: This setting will not affect any current authenticated sessions. 


Report Page Execution Timeout | 900 $ | seconds 


Apply 
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2 In the Grid Page Size field, specify the number of entries you want displayed. 


3 In the Authentication Timeout field, specify the minutes of inactivity before you will need to log 
in again. 


4 Click Apply. 
5 When you are notified that the Web interface configuration was saved, click OK. 
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3.3.3 


Viewing System Information 


When you work with a Micro Focus Support representative to diagnose the source of a problem, you 
might be asked to access the System Info page. To do so, simply select System Configuration from the 


Main menu. 


File Reporter 4.0 Main ~ 


Database Statistics 


Database Version String 


Database Total Size 
Database Host Address 
Database Name 
Database Schema Version 


Scans 
Total Size of Scans 

File System Metadata Scans 
Permision Scans 

Volume Trend Scans 


Identity System Data 

Identity Systems Count 
Identity System Cached Objects 
Identity Systems Size 


ystems ~ File Content ~ Microsoft 365 ~ Reports 


Microsoft SQL Server 2019 (RTM) - 15.0.2000.5 (X64) 

Sep 24 2019 13:48:23 

Copyright (C) 2019 Microsoft Corporation 

Standard Edition (64-bit) on Windows Server 2019 Standard 10.0 <X64> (Build 17763: ) 
(Hypervisor) 

150,994, 944 bytes 

localhost 

srsdb 

4.0.0.1 


8,413,184 bytes 
1 


1 
o 


” 


1,090 
1,294,336 bytes 
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Configuration ~ Administrator 


System Info 
Referenced Web Application Assemblies 

Name Version Processor Architecture 

Condrey.Product None a 
CondreySrs.Core 4.0.8.0 None 

CondreySrs.Core Database 4.0.0.2 None 

CondreySrs.CoreExt 4.0.0.6 None 

CondreySrs Product 4.0.12.0 None Y 
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4.1 


Performing Setup Procedures 


Before you can start scanning storage resources and generating reports, you first need to perform 
some setup procedures. 


+ Section 4.1, “Viewing Storage Resources,” on page 29 
+ Section 4.2, “Assigning Proxy Targets,” on page 31 
+ Section 4.3, “Configuring Notifications,” on page 32 


+ Section 4.4, “Integrating with File Dynamics,” on page 33 


Viewing Storage Resources 


When Active Directory has been enabled, the associated storage resources are available for scanning 
and reporting. 


File Reporter cannot see a Windows network disk drive that is not shared. 


1 Select Configuration > Storage Resources. 


P Decovery Option Sehed — Rebus E Petre Storage Resources 


Resource Operating System File System — Last Update Last Update Attempt Last Status 


Oooo 


All of the servers in the Active Directory forest are displayed. 
2 Click each button to view options. 


Discovery Options: For large organizations with Active Directory forests spanning multiple 
geographic areas, rebuilding the storage resources can take many hours. Rather than rebuilding 
the storage resources, you can select this to create a scope that specifies just those new 
containers or servers that need added. 
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Storage Resource Discovery Options - sp.cctec.org 


| (O) Scope by Container List O Scope by Server List 
Container FDN 


New 
No Containers defined. The entire sp.cctec.org forest will be searched. 


Cancel 


Select whether to specify the servers through a container FDN or server FDN, then click New to 
enter the paths. Specify the FDN path and click Update. When all of the paths you want to be 
searched are listed, click OK. 


Schedule: By default, File Reporter rebuilds Active Directory’s storage resources at 12:00 AM 
each day. Larger sites might want change this setting to weekly or on a specific day of the 
month. To do so, click this option and modify the settings in the dialog box. 


Rebuild: Clicking this button automatically rebuilds Active Directory’s storage resources. 
Rebuild Only Selected Servers: Use this option to rebuild the selected servers. 
Refresh: Refreshes the resource list. 


3 Click the > for each server to browse the storage resources. 


vom 


AER 


A] 
8 3 
3 
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4.2 Assigning Proxy Targets 


An Agent cannot be deployed on a NAS device or storage cluster. Additionally, only one Agent type 
(AgentFS, AgentFC, or Agent365) can be hosted on a server. Finally, some organizations might not 
want Agents deployed on every server. In situations such as these, you can have a deployed Agent on 
another server function as a proxy agent. 


1 Select File Systems > Scan Agents. 
All of the Agents are listed. 


File Reporter 4.0 


S Refresh File System Scan Agents 


O Agent Server Agent Type Version Identity System Support Last Heartbeat Proxy Count Status Message 


2 Select the Agent you want to set up as a proxy agent and click Assign Proxy Targets. 


Assign Proxy Targets for srs-m1.sp.cctec.org 


Server Server Type Identity System Current Proxy Agent 
oO dc.sp.cctec.org Windows sp.cctec.org 
srs-m2.sp.cctec.org Windows sp.cctec.org 
O srs-m3.sp.cctec.org Windows sp.cctec.org 
O w2k8r2.sp.cctec.org Windows sp.cctec.org 


Nes 


3 Select the proxy targets and click OK. 
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4.3 Configuring Notifications 


Notification parameters specify what types of notifications are listed and how email notifications are 
sent. 


1 Select Configuration > Notifications. 


File Reporter 4.0 Main*  FileSystems + File Content ~ Governance ~  Microsoft365v Reports ~ Configuration ~ L 5P\Administrator 


Notification Configuration 
Notification Settings 
Only notify me about events of at least this severity level: Success x 


Days to display notifications in the dashboard: 30 


Enable Mail Notifications 


Mail Settings 

Mail Server: 

Port: 25 : 

Connection Type: TLS z 


From Email Address: 


Use Authentication 


Username: 


Password: 


Minutes to buffer multiple notications for a single email: 1 


Save Changes 
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Only notify me about events of at least this severity level: This field lets you specify the 
severity level of events that are recorded and displayed in the Notifications page and through 
email notifications. 


The severity levels are listed from lowest to highest, with Success being the default setting. 


If you change the severity level, File Reporter records and displays only the events for that 
severity level and higher. Older notifications from formerly recorded severity levels continue to 
be displayed in the Notifications page. For example, if you change the setting from Success to 
Warning, only warning and error events are recorded, but the formerly recorded success and 
info events are still displayed, unless you filter them out. 


To avoid receiving emails for every successful event, you should modify this setting to a more 
restrictive level. 


Days to display notifications in the dashboard: This field indicates the number of days an event 
is listed in the Notifications page. 


Enable Mail Notifications: Clicking this activates the fields in the Mail Settings region of the 
page. 


Email notifications are sent to all members of the SrsAdmins group. File Reporter finds each 
member’s email address from Active Directory. 
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Mail Server: Specify the IP address or hostname of the mail server to use for sending the email 
notifications. 


Port: Specify the port number used by the mail server. 
Connection Type: Specify the encryption type used by the mail server. 


From Email Address: Specify the address you want displayed in the From field of the email 
notifications that are sent. 


Use Authentication: If your mail server requires authentication, select this. 
Username: Specify the mail server username. 
Password: Specify the mail server password. 


Minutes to buffer multiple notifications in a single email: File Reporter can consolidate 
messages into a single email notification. If you change this setting to 5, File Reporter 
consolidates all of the events that took place in 5 minutes and emails you a notification. 


2 Specify your notification parameters and click Save Changes. 


Integrating with File Dynamics 


If you have Micro Focus File Dynamics deployed, you can use Micro Focus File Reporter to report on 
File Dynamics policies. Before you can do so, you must first specify the server address and port 
number of the server hosting the File Dynamics Engine. 


IMPORTANT: File Reporter 4.0 integrates with File Dynamics 6.0 and above. 


1 Select Configuration > File Management. 


File Reporter 4.0 Main ~ File Systems + File Content ~ Governance ~ Microsoft 365 ~ Reports + Configuration ~ Ê sP\Administrator 


IS Refresh File Management Integration 
Engine Communication 
Server Address 


Port 3009 


Save Changes 
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2 Specify the IP address or DNS name of the server hosting the File Dynamics Engine. 
3 Specify the port number that the Engine is using. 

The default port number is 3009. 
4 Click Save Changes. 
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5.1 


Scheduling and Performing File System 
Scans 


+ Section 5.1, “Scans,” on page 35 

+ Section 5.2, “Adding a Scan Target,” on page 36 

+ Section 5.3, “Removing a Scan Target,” on page 38 

+ Section 5.4, “Creating Scan Policies,” on page 38 

+ Section 5.5, “Establishing a Baseline Scan,” on page 42 

+ Section 5.6, “Clearing a Baseline Scan,” on page 43 

¢ Section 5.7, “Editing a Scan Policy,” on page 43 

+ Section 5.8, “Deleting a Scan Policy,” on page 43 

+ Section 5.9, “Scheduling Scans,” on page 43 

+ Section 5.10, “Editing a Scheduled Scan,” on page 45 

+ Section 5.11, “Clearing a Schedule on a Scheduled Scan,” on page 45 
¢ Section 5.12, “Conducting an Immediate Scan,” on page 45 
+ Section 5.13, “Viewing Scans in Progress,” on page 45 

¢ Section 5.14, “Retrying Failed Scans,” on page 46 

¢ Section 5.15, “Viewing Scan Data,” on page 47 

+ Section 5.16, “Viewing Scan History,” on page 47 

+ Section 5.17, “Troubleshooting a Failed Scan,” on page 48 


+ Section 5.18, “Scanning Your Microsoft 365 Tenant,” on page 48 


Scans 


Through AgentFS, Micro Focus File Reporter takes a file system “scan” of the file system’s storage 
resource at a given moment. A storage resource is a Microsoft network share. 


File system scans are indexed data that are specific to a storage resource. They are the means of 
generating a storage report or analytics views. Scans include comprehensive information on the file 
types users are storing, when files were created, when they were last modified, permission data on 
the folders where these files reside, and much more. 


File Reporter collects file system scans from the Agents, compresses them, and sends them to the 
Engine, where the Scan Processor takes them and uploads them to the database. 


File system scans can be taken at any time, but we recommend using a scheduled time after normal 
business hours to minimize the effect on network performance. 
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5.1.1 


5.2 


You should consider a number of factors as you decide how often to conduct a file system scan: 
+ Although daily scanning always provides the most up-to-date information, scanning is not 
throttled and might place a considerable load on the server hosting the Agent. 
+ Most storage resources do not change rapidly enough to justify daily scanning. 


+ Monthly scanning places the least total load on individual servers and on the network, but scans 
are not as up-to-date as they could be. 


+ You can scan frequently-changing shares more often and scan the more static shares less often. 


+ Part of the decision concerning scanning frequency involves the primary purpose of the 
reporting. Reporting on storage trending can generally use less frequent scans, but reporting 
that is intended to solve immediate problems, such as “Who filled up this volume?” needs more 
frequent scans. 


+ When information is needed immediately, you can manually trigger a scan. 


¢ For installations where you are not sure of the optimal scanning frequency, you can start with 
weekly scanning, and then adjust that interval based on the needs of the particular site. 


Scan Retention 


By default, File Reporter only retains the most current file system scan and permissions scan of a 
storage resource. However, if you want to generate Historic Comparison reports, which let you 
compare two scans of the same storage resource over two points in time, you will need to specify 
that scans be retained. Depending on the retained scan type, this is done either manually or 
automatically. 


Manual Retention 


You can specify that a file system or permissions scan be retained indefinitely as a “Baseline scan” by 
manually specifying it in the Scan Data page. For procedures and more information on Baseline 
scans, see Section 5.5, “Establishing a Baseline Scan,” on page 42. 


Automatic Retention 


Within the scan policy, you can specify that the last file system scan or permissions scan be retained 
when a new file system scan or permissions scan is conducted. This version is known as a “Previous 
scan.” For procedures and more information on Previous scans, see Section 5.4, “Creating Scan 
Policies,” on page 38. 


Adding a Scan Target 


All shares must first be specified as a scan target before they can be scanned. 


1 Select File Systems > Scan Targets. 
2 Click Add. 


3 Click the > to view the shares of the listed servers. 


Scheduling and Performing File System Scans 


Storage Resource Browser © 
Resource Filter: Apply Filter Refresh 
Y  sp.cctec.org = 
O \\desp.cctec.org\ADMINS NTFS 
O \desp.cctec.org\C$ NTFS 
O \\dc.sp.cctec.org\NETLOGON NTFS 
[O  \\desp.cctec.org\SYSVOL NTFS 
O \\srs-m1.sp.cctec.org\ADMINS NTFS 
O \\srs-m1.sp.cctec.org\C$ NTES 
O \\srs-mLsp.cctec.org\ES NTES 
O \\srs-mLsp.cctec.org\F$ NTES 
O \\srs-mLsp.cctec.org\refs-share NTES 
O \\srs-mLsp.cctec.org\SearchResults NTFS 
O Wsrs-m1.sp.cctec.orgiShares NTFS = 
Cancel 


4 Select the shares you want File Reporter to be able to scan and click OK. 
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The scan targets are added. 


File Reporter 4.0 Main ~ 


Gad © G Refresh Ej Rebuild Storage Resources File System Scan Targets 


O Identity System Target Path File System id 


5.3 Removing a Scan Target 


1 Select File Systems > Scan Targets. 


2 Select the check box pertaining to the share you want to remove as a scan target and click 
Delete. 


3 When the confirmation dialog box appears, click Yes. 


5.4 Creating Scan Policies 


The specifications for a scan are established in a scan policy. The scan policy specifies the following 
parameters: 

+ What type of scan to conduct (File System, Permissions, or Volume Free Space) 

+ The scan targets 

+ Scan retry settings 


+ The scan schedule 


IMPORTANT: The scan policy name must be unique. If you attempt to give the scan policy an existing 
name, File Reporter generates an error. 


1 Select File Systems > Scan Policies. 
2 Click Add. 
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New Scan Policy 


— ne Po 


Policy Type 


In the Scan Policy Name field, specify a name for the scan policy. 
You can provide a description of the policy in the next dialog box. 
Select the type of scan that File Reporter is to conduct. 


File System: Scans the files currently stored on the network share, the size of those files, when 
the files were last accessed, the locations of duplicate versions, and so forth. 


Permissions: Scans the permissions pertaining to the folders stored on the shares. 
Volume Free Space: Scans the availability of free space on the shares. 
Click OK. 
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Scan Policy Editor 


Name:* FS Scan Policy 

Description: File System scan for current share 

Retry Count: 3 $ 

Retry Interval: 60 ^ Minutes v 


Directory Quotas: g Scan Directory Quotas 

Previous Scans: O Save Previous Scan 

Content Hash: [C] Generate file content hashes 
All Files 


Files updated since last scan 


Name: Displays the name of the scan policy. 
Description: Specify a description of the scan policy in this field. 


Retry Count: Specify the number of times File Reporter attempts to scan the storage resource 
targets listed in the scan policy if there is a failure. 


Retry Interval: Specify the amount of time before File Reporter retries scanning the storage 
resource targets listed in the scan policy if there is a failure. 


Directory Quotas: By default, a scan does not include home folder quota information, because 
gathering this information on Windows shares can extend the scan time significantly. Unless 
you plan to generate a Directory Quota report, we recommend that you leave this option 
deselected. 


This option applies only to File System scans. 


Previous Scans: This option lets you specify whether to keep the previous version of a scan 
generated through this policy. This scan is known as the “Previous scan” which you can then use 
to generate a Historic Comparison report through a comparison with either a Baseline scan or a 
“Current scan.” For more information, see Section 6.8, “Historic Comparison Reports,” on 
page 81. 
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Previous scans are designated whenever a new scan is performed. The new scan is the Current 
scan and the earlier scan becomes the Previous scan. When the target paths are eventually 
scanned again, the new scan becomes the Current scan, the earlier Current scan becomes the 
Previous scan, and the former Previous scan is deleted. 


NOTE: If you want to maintain a scan indefinitely, you can do so by specifying it as a Baseline 
scan. For more information, see Section 5.5, “Establishing a Baseline Scan,” on page 42. 


The management of Previous scan retention occurs when processing a new scan. This means 
that if you deselect Retain existing Previous scan, no existing Previous scan will be removed at 
that time, but it will be removed when a new scan is processed. 


Content Hash: Selecting this check box enables File Reporter to create a content-based hash for 
each file in the specified target path. These hashes can then be compared through a Custom 
Query report to find duplicate files based on hash comparisons. 


While File Reporter has always had a Duplicate File report option in its built-in reports, its 
reporting is based solely on metadata comparisons. Generating a duplicate file report through 
content has comparisons can be much more accurate. 


For more information on generating a duplicate file report through content-based hashes, see 
Section 6.11.1, “Generating a Content Hashed Duplicate File Report,” on page 90. 


All Files: Selecting this check box creates a new individual hash for each file in the specified 
target path. 


Files updated since last scan: Selecting this check box creates an individual hash for each file 
that does not already have a previously created hash or for files updates since the hash was 
created. 


NOTE: Generating a content hash for each file will cause AgentFS to take longer to perform the 
scan. Generating hashes only for new or updated files can save a significant amount of time for 
subsequent scans. 


Add: Click this option to specify the scan targets for the scan policy. 


IMPORTANT: After a target has been added to a scan policy, the same target cannot be added 
to another scan policy of the same scan policy type. 


Clicking Add brings up a dialog box like the one below where you can select available storage 
resources. 
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5.5 


Scan Target Browser 


Identity System Target Path 
O sp.cctec.org \\srs-mL.sp.cctec.org\refs-share 
O sp.cctec.org \\srs-m1L.sp.cctec.org\SearchResults 
O sp.cctec.org Ysrs-m1.sp.cctec.orgíShares 
g sp.cctec.org \\srs-mL.sp.cctec.org\test-100 


6 Click OK to save the scan policy. 


The scan policy is now displayed on the Scan Policies page. 


C Polley Name Sean Type Target Paths — Save Previews Sehedute Retry Count Retry Inverval w 


o pas 


The scan policy still needs to be scheduled. For procedures on scheduling scans, go to 
Section 5.9, “Scheduling Scans,” on page 43. 


Establishing a Baseline Scan 


A Baseline scan is a scan that you save as a reference for a comparison with another scan. You 
compare scans when you generate a Historical Comparison report. Unlike a Previous scan, which 
gets replaced as a new Current scan is created, a Baseline scan is retained indefinitely until you 
decide to delete it. You can have only one Baseline scan per scan target. 
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5.7 


5.8 


5.9 


IMPORTANT: Because you can have only one Baseline scan per scan type for a scan target, 
establishing a scan as a Baseline will override any established Baseline scan of the same scan type for 
the same scan target. 


1 Select File Systems > Scan Data. 


2 Inthe far left column, select the check box pertaining to the scan you want to set as a Baseline 
scan. 


3 Click Set Baseline. 


4 When the confirmation dialog box appears, click Yes. 


Clearing a Baseline Scan 


Scans designated as Baseline scans are retained until the baseline designation is cleared. If a Baseline 
scan that is in the Retained state has its Baseline status removed, that scan will be immediately 
marked for deletion. 

1 Select File Systems > Scan Data. 


2 In the far left column, deselect the check box pertaining to the scan you want to clear as a 
Baseline scan. 


3 Click Clear Baseline. 


4 When the confirmation dialog box appears, click Yes. 


Editing a Scan Policy 


1 Select File Systems > Scan Policies. 

2 Click the check box that pertains to the scan policy that you want to edit. 
3 Click Edit. 

4 Change any of the settings you wish. 

5 Click OK. 


Deleting a Scan Policy 


1 Select File Systems > Scan Policies. 
2 Click the check box that pertains to the scan policy that you want to delete. 


3 Read the warning and click Yes. 


Scheduling Scans 


1 Select File Systems > Scan Policies. 
2 Click the check box that pertains to the scan policy for which you want to create a schedule. 
3 Click Edit Schedule. 
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Schedule for Munich Users FS Scan Policy 


SCHEDULE START 


Engine Local Time:* 12:00 AM 


<> 


Engine Local Start Date:* 6/12/2018 v 


SCHEDULE RECURRENCE 


Daily 


Weekly 


OO@O0d 


Monthly 


Day 


The 


Engine Local Time: Specify the time that you want the scan to begin. 


The time you select is based on the time zone where the Engine is located and not the Agent 
that conducts the scan. 


Engine Local Start Date: Specify the date when you want the scan schedule to take effect. 


Be aware that entering a date does not mean that the scan takes place on that date. If the 
Engine Local Start Date is set for today, which is a Monday, but the Schedule Recurrence setting is 
set for Weekly on Sunday, the scan does not take place until Sunday. 


Once: Select this option to scan the storage resources specified in the scan policy only once. 
Daily: Select this option for a daily scan of the storage resources specified in the scan policy. 


Weekly: Select this option and specify a weekday for a weekly scan of the storage resources 
specified in the scan policy. 


Monthly: Select this option and specify a day for a monthly scan of the storage resources 
specified in the scan policy. 


4 Specify the scheduling parameters and click OK. 
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5.10 


5.11 


5.12 


5.13 


Editing a Scheduled Scan 


1 Select File Systems > Scan Policies. 

2 Click the check box that pertains to the scan policy for which you want to edit a schedule. 
3 Click Edit Schedule. 

4 Make the schedule changes you want. 

5 Click OK. 


Clearing a Schedule on a Scheduled Scan 


1 Select File Systems > Scan Policies. 
2 Click the check box that pertains to the scan policy for which you want to clear a schedule. 
3 Click Clear Schedule. 


4 When the confirmation prompt appears, click Yes. 


Conducting an Immediate Scan 


1 Select File Systems > Scan Policies. 


2 Click the check box that pertains to the scan policy for which you want to conduct an immediate 
scan. 


3 Click Scan Now. 


4 When the confirmation prompt appears, click Yes. 


Viewing Scans in Progress 


You can view details on the scans that are in progress through the Scans in Progress page. When the 
scan has been completed, you can view the details in the Scan History page. 


1 Select File Systems > Scans in Progress. 
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Ocnei Retry Refresh File System Scans in Progress 


As you click Refresh, the completed scan listings are removed and listed in the Scan Data and 
Scan History pages. 


5.14 Retrying Failed Scans 


In the Scan Policy Editor dialog box, the default scan policy settings for Retry Count is three and the 
Retry Interval is 60 minutes. You can adjust each of these settings. Assuming the default settings are 
not adjusted, File Reporter retries the scan in 60 minutes and only retries to scan up to three times. 


Until File Reporter has attempted all three retries, the failed scans remain listed on the Scans in 
Progress page. After all retries have been performed, the scan listing is moved to the Scan History 
page. 


As long as a failed scan is listed on the Scans in Progress page, you can retry the scan manually by 
doing the following: 


1 From the Scans in Progress page, select the check box corresponding to the failed scan. 
2 Click Retry. 
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5,15 Viewing Scan Data 


The Scan Data page lets you view a minimal set of details pertaining to the currently available scans 
for each scan target. 


1 Select File Systems > Scan Data. 


o S Refresh File System Scan Data 


O Scania Sean Target Scan Type State T Baseline Triggered Scan Time Policy Agent Status 


241 Fie System Data Previous False 33:21PM shares? SRS-M1 stul 

spcctecorg\test -99 Fhe System Data Current False s SRS-M1 essful 
o 2 \ere-mLepectecong\tst-157 Fe System Data Current False 9/21/2020 6:15:24 PM — ost fs SRS-M1 (0) Operation successful 
O 3 " ecorgirest-136 Fie System Data Curren False est RS-M1 eration successful 
o 23% Vr s- mlspectecargirest-135 Fite System Dara Current False rest ts SRS-MI (0) Operation successful 
O mispectecorg\test-134 Fée System Data Current False 0/21/2020 6:15:24 PM test ts SRS-ML (0) Operation successful 

Fe System Data Current False test fs SRS-M1 (0) Operation successful 
o te System Data Current Faise + SRS-MI tul 
O Fte System Data Current False test fs SRS-MI (0) Operanon successful 
o le System O rent Fal est SRS-MI 
o Current Fat est SRS-M1 
n Currant False rest fe SRS-M1 (0) Operation wurcesstul y 
; n 
gh dr a 


5.16 Viewing Scan History 


The Scan History page displays a complete history of all scans, along with details of the scan and 
some basic information of the storage resource at the time of the scan, including the file and folder 
count. 


1 Select File Systems > Scan History. 


Scheduling and Performing File System Scans 47 


48 


Sean dd Start Time Sean Target Sean Policy Scan Type Agent Scan Duration File Count 


You can click the columns to list the data in ascending or descending order. 


Because the Scan History page logs each successful scan, the most efficient way of locating a 
scan is using a filter. 


5.17 Troubleshooting a Failed Scan 


5.18 


Verify that the Agent service is running properly on its host machine. 


Verify that the host machine where the Agent is installed has enough free disk space to 
temporarily store a copy of the scan in its uncompressed and compressed form. 


If an Agent is not installed directly on the server with the storage resource you want to scan, 
verify that a proxy assignment for the storage resource has been established. 


If the proxy agent is not scanning, assign the storage resource from a different proxy agent and 
try scanning again. 


Verify that the proxy rights group has been assigned the proper rights to the share. 


The proxy rights group must be assigned to the builtin\administrators group or the local 
administrators group on the server where the scan is being conducted. 


Verify that the Windows Firewall is configured to permit network traffic to flow between the 
Engine and the Agent. 


For more information on the Windows Firewall, see Section B.2, “Firewall Requirements,” on 
page 161. 


Scanning Your Microsoft 365 Tenant 


Scanning your Microsoft 365 tenant identifies all users and groups, the associated drives, sites and 
associated libraries, teams and their associated libraries, and channels and their associated libraries. 
A tenant scan includes details pertaining to the file system structure, individual files, and file and 
folder permissions. 
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5.18.1 Scan the Microsoft 365 Tenant 


1 Select Microsoft 365 > Tenant. 


File Content + Governance + Microsoft 365 ~ Configuration + A sp\administrator 


File Reporter 4.0 Main=> File Systems ~ 


Microsoft 365 Tenants 


> ‘S Refresh 
g a colum oup by 1 mn 
O  JobStatus Tenant Counts 
condreycorprpl Users 0/0 Sites 20/20 
Y Complete 
O da condreycorprplonmicrosoft.com / sp.cctec.org Groups o/o Teams o/o 
7 90944 1e7-f038-4əc2-0e78-7872f5€5784e Drives 21/21 Channels o/o 


Copyright 2020 Condrey Corporation 


2 Select the check box associated with the listed tenant, then click Scan. 


The progress of the scan is displayed in the Counts column. 


A sP\administrator 


File Systems ~ File Content | Governance  Microsoft365 Reports ~ Configuration ~ 


File Reporter 4.0 Main ~ 


Microsoft 365 Tenants 


> IS Refresh 
re to group by t mn 
O seb status Tenant Counts 
condreycorprpl Users 0/0 Sites 20/20 
Q) Processing [ Cancel] TERT 3 
condreycorprplonmicrosoft.com / sp.cctec.org Groups o/o Teams oro 
Drives 20/21 Channels o/o 


1D: 2 
00944 1e7-f058-Lac2-0e78-7872fSe578ke 


Copyright 2020 Condrey Corporation 


You can also monitor the progress of the scan among the various drives by selecting Microsoft 
365 > Drives. 
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File Reporter 4.0 Main + File Systems + File Content + Governance Microsoft 365 + Reports + Configuration + L SA administrator 


> scan Sj Refresh Microsoft 365 Drive Scans 
Scan Status 
Files o 
Y Complete Document Library Folders 2 https://condreycorprpl.sharepoint.com/sites/created-to-be-deleted/Shared%20Documents 13 
Permissions 6 
Files o 
O Y Complete Document Library Folders 1 https-//condreycorprpl.sharepoint.com/sites/contentTypeHub/SharedX20Documents 14 
Permissions o 
Files 3 
O Y complete Business Folders 3 https://condreycorprpl-my.sharepoint.com/personal/rlagger_condreycorprpl_onmicrosoft_com/Documents 15 
Permissions 6 
Files 438 
9 Processing [ Cancel ] Document Library Folders 21 https:/condreycorprplsharepoint.com/sites/condreycorprpV/Shared%20Documents 16 
Permissions 1,835 
Files o 
V Complete Document Library Folders 1 hitps:ffcondreycorprplsharepoint.com/sites/TestTeam1/Shared%20Documents 17 
Permissions 1 
Y Complete Business Folders 4 https:i/condreycorprpl-my.sharepoint.com/personal/gnance_sp_cctec_org/Documents 18 
Permissions 37 
Files 3 
OY complete Document Library Folders 6 hrtps//condreycorprpl. sharepoint.com/sites/Finance_Team/SharedX20Documents 19 
Permissions 34 
Files 1 
Y Complete Document Library Folders 1 htps-//condreycorprpl.sharepoint.com/sites/condreycorprpl/musings/SharedX20Documents 20 
Permissions 6 
Files 1 =. 
Copyright 2020 Condrey Corporation 


Once the Job Status column indicates that the scan is complete, you can then generate a 
Microsoft 365 report. For procedures for doing so, see Section 6.11.2, “Generating Microsoft 
365 Reports,” on page 97. 


5.18.2 Scan Selected Drives 


There might be instances where after the initial tenant scan, that changes were made to only a 
select number of libraries. Rather than rescan the entire tenant, you can select the specific drives to 
scan. 


NOTE: More significant changes, such as the addition of a new team and consequently the creation 
of a new drive, requires a tenant scan for the drive to be scanned. 


1 Select Microsoft 365 > Drives. 


2 Select the check boxes associated with the listed drives you want to scan, then click Scan. 
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6 Generating File System Reports 


6.1 


+ Section 6.1, “Overview,” on page 51 

+ Section 6.2, “Changing Your Cover Sheet Branding,” on page 52 

+ Section 6.3, “Changing the Report Data Font,” on page 54 

+ Section 6.4, “Built-in Report Types,” on page 55 

+ Section 6.5, “Directory Data Reports,” on page 56 

+ Section 6.6, “Permissions Reports,” on page 66 

+ Section 6.7, “File Data Reports,” on page 70 

+ Section 6.8, “Historic Comparison Reports,” on page 81 

+ Section 6.9, “Trending Report,” on page 85 

+ Section 6.10, “Unformatted Reports,” on page 86 

+ Section 6.11, “Custom Query Reports,” on page 87 

+ Section 6.12, “Micro Focus File Dynamics Policy Reports,” on page 100 
+ Section 6.13, “Scheduling Reports,” on page 101 

+ Section 6.14, “Editing a Scheduled Report,” on page 103 

+ Section 6.15, “Clearing a Schedule on a Scheduled Report,” on page 103 
+ Section 6.16, “Copying a Report Definition,” on page 103 

+ Section 6.17, “Viewing Reports in Progress,” on page 104 


+ Section 6.18, “Troubleshooting Reports,” on page 105 


Overview 


After you have conducted scans on storage resources, Micro Focus File Reporter has the content 
needed to generate reports. The type of report you can generate depends on the type of scan that 
you have conducted. For example, in order to create an Assigned NTFS Permissions report, a 
Permissions scan on a Windows share must first be conducted. 


All reports are created by first creating report definitions. The report definition specifies the report 
name, type, target path to the scans, and more. 


IMPORTANT: The report definition name must be unique. If you attempt to give the report 
definition an existing name, File Reporter generates an error. 


File Reporter has built-in aggregate reporting capabilities, meaning that you can specify multiple 


target paths in the same report. Additionally, File Reporter has built-in scoping, which allows you to 


browse through the file path or Active Directory and specify the level where you want to start 
reporting data. Finally, Boolean filtering is available for all File Data Reports. For more information, 
see Appendix A, “Filtering for Built-in Reports,” on page 155. 
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6.2 


When the definition has been saved, you can generate the report immediately or schedule it to be 
generated. 


You can generate reports in either Preview or in Stored Report mode. Preview lets you view the 
report where you can save it locally if you want to. Stored Report saves the report to the server 
hosting the Engine, where it remains for a set amount of days. 


You can generate Detailed Reports from certain built-in report types. For example, a File Extension 
Report can be the means of generating a Detailed Report that includes the specific details of all of 
the * . mov files. 


All built-in reports include a cover sheet that you can customize to include your organization’s logo. 


Changing Your Cover Sheet Branding 


All generated built-in reports include a cover sheet that includes a default graphic. If you want, you 
can replace it with your organization’s logo. 


1 Select Reports > Report Definitions. 


2 Select Report Branding and Styling > Report Branding. 
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Report Branding 


Company Name: 


Company Logo: 


Images must meet the following criteria: 
* Less than one megabyte (1 MB) 
+ Dimensions no larger than 500x400 pixels 
e File format is one of the following: 
= PNG (png) 
= JPEG (jpg, * jpeg) 
= BMP (bmp) 


Browse... RESET 


3 In the Company Name field, specify the name of your organization. 
This is the name that appears on the front cover. 


4 Click Browse, then browse to and replace the default logo with a new logo. 
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6.3 


Report Branding 


Company Name: CCTEC 


CCTEC 


Images must meet the following criteria: 
e Less than one megabyte (1 MB) 
+ Dimensions no larger than 500x400 pixels 
e File format is one of the following: 
= PNG (png) 
= JPEG (jpg, *jpeg) 
= BMP (*.bmp) 


Browse... RESET 


5 Click Save. 


Changing the Report Data Font 


Due to limitations of font encoding in PDF files, you might need to specify an alternate report data 
font. Locales that have multi-byte characters or characters outside the Latin-1 set of characters 
supported by the default font are especially at risk. 


If you know the collected data is limited to a specific locale or language, choose a font that properly 
displays all characters for that locale or language. 


If the collected data might contain characters that span multiple locales or that include both multi- 
byte and Latin-1 characters, for example, choose an appropriate Unicode Font that can accurately 
display most characters from the Unicode set and not just a specific locale. 


Two Unicode fonts known for having both good Unicode character coverage and good glyph 
presentation are MS Arial Unicode (a sans-serif font) and CODE2000 (a serif font). 
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6.4 


For more information on these fonts and on Unicode fonts in general, see http://en.wikipedia.org/ 
wiki/Unicode_font. 


NOTE: You can change the data font to any font that is available on the server hosting the Web 
Application. 


Headers and parameters in the reports remain in the default Arial font. 


To change the report data font: 


1 From the Reports menu, select Report Definitions. 
2 From the Report Branding and Styling drop-down menu, select Report Data Font. 


3 From the Report Data Font Name drop-down menu, select the font you want displayed in the 
report. 


4 Click Save. 


Built-in Report Types 


File Reporter has five different built-in report type classifications: 


¢ Directory Data 

+ Permissions 

+ File Data 

¢ Historic Comparison 


+ Trending 


Each classification includes one or more report types. For example, in the Permissions category, 
there are three different reports that can be generated. 


For more information about the procedures for generating built-in reports according to 
classification, see the following sections: 

+ Section 6.5, “Directory Data Reports,” on page 56 

+ Section 6.6, “Permissions Reports,” on page 66 

+ Section 6.7, “File Data Reports,” on page 70 

+ Section 6.9, “Trending Report,” on page 85 

+ Section 6.10, “Unformatted Reports,” on page 86 
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6.5 Directory Data Reports 


Reports in this classification include Summary, Directory Quota, Storage Cost, and Comparison 
Reports. 


Before generating any type of Directory Data report, you must first conduct a File System scan on the 
shares you want to report on. 


¢ Section 6.5.1, “Generating a Summary Report,” on page 56 
¢ Section 6.5.2, “Generating a Directory Quota Report,” on page 63 
+ Section 6.5.3, “Generating a Storage Cost Report,” on page 64 


¢ Section 6.5.4, “Generating a Comparison Report,” on page 65 


6.5.1 Generating a Summary Report 


Summary reports provide a summary of the contents of folders according to a specified level in the 
file system. 


1 Select Reports > Report Definitions. 
2 Click Add. 


Add Report Definition 


Name:* 


Unformatted: O Create report as Unformatted (for use with Text, Csv, or XIs exports) 


Directory Data File Data 

O Summary O Filename Extension O Filename Extension Detail 
O Directory Quota O Owner O Owner Detail 

O Storage Cost O Duplicate File O Duplicate File Detail 

O Comparison O Date-Age O Date-Age Detail 
Permissions Historic Comparison 

O Assigned NTFS Permissions O File System Comparison 

O Permissions by Path O NTFS Permissions Comparison 


O Permissions by Identity 


Trending Custom Query 


O Volume Free Space O Custom Query Report 


3 In the Name field, specify a descriptive name of the report definition. 
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For example, User Volume Summary Report. 
The name can contain up to 64 alphanumeric characters. 


4 Select the Summary option and click OK. 


Report Definition Editor - Atlanta User Share Summary Report 


Atlanta User Share Summary Report Report Path Depth o $ 
Summary Report A 
Initial Chart Path Depth 0 y 

Report Definition created on 12/2/2020 8:07:05 PM by fi} A Report Path Depth greater than 3 or 4 may result in significant report 


SP\Administrator 


size and processing time 


TARGET PATHS FILE MANAGEMENT POLICIES 


Add Remove 


li 


5 Inthe Report Path Depth field, specify the depth of reporting. 


For example, if you select 3, the Summary report lists the file contents of all file paths in the 
specified shares up to 3 levels in the file structure. 


For example, for a server named srs-mlsp, the Summary report would list the contents of these 
paths: 


\\srs-misp.cctec.org\Shares\Home\Usersi 
\\srs-misp.cctec.org\Shares\Home\Users1\a 
\\srs-misp.cctec.org\Shares\Home\Users1\a\stuff 
\\srs-misp.cctec.org\Shares\Home\Usersi\a\stuff\morestuff 


6 In the Initial Chart Path Depth field, specify the initial path depth for inclusion in the Top Ten 
Folders by Size chart that is displayed in the report header section. 


This is important so that when the Report Path Depth is greater than zero, the top level folders 
are now conditionally included. The Chart Path Depth parameter is not allowed to be greater 
than the currently specified Report Path Depth. 


7 From the Target Paths tab, click Add. 


Generating File System Reports 57 


58 


Scan Data Browser - File System Data 


vy EN sp.cctec.org 
> O f= \\srs-m1.sp.cctec.org\refs-share 


X go F= \\srs-m1.sp.cctec.org\Shares 


> [) Atlanta 

> C] j Home 

> O a¿sro 

> () itest 
F= \\srs-m1.sp.cctec.org\Shares2 
F= \\srs-m1.sp.cctec.org\test-1 


Fe Wsrs-m1.sp.cctec.orgltest-10 


F= \\srs-m1L.sp.cctec.org\test-101 


Fe \\srs-m1.sp.cctec.org\test-102 


O 
O 
O 
> (J) B\\srs-misp.cctec.org\test-100 
O 
O 
m7 


Es VWereem1 en ortar armitart1MT 


8 Click the > to browse to and select the file paths you want included in the report, then click OK. 


You must expand the Active Directory forest to be able to select the shares, even if you want to 
select the root of the Active Directory forest. 


9 Click Save. 
The report definition is added to the list. 
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Report Branding and Styling E Refresh Report Definitions 


O Name Report Type Targets File Management Policies Report Owner Schedule 
Q mm Query 5 m 
a m m spiadm a 
Oar som O a = 
gojas m 
Oa & m Query = 
0a ms r m Query (G thee Schache 
Oa as men fl 1 
Q om a 
a m m mato a 
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10 Do one of the following: 


+ Generate the report in Preview mode by following the procedures under “Generating a 
Preview Report” on page 59. 


+ Generate the report in Stored mode by following the procedures under “Generating a 
Stored Report” on page 61. 


Generating a Preview Report 


A preview report is generated from scan data in the database and is temporarily cached in the Web 
application's data folder. When you close a preview report, you cannot access the report again until 
you generate a new one using the same report definition. 


When you view a report in Preview mode, you can print the report or save the report locally. 


1 From the Report Definitions page, select the report definition from which you want to generate 
a report. 
2 Select Generate > Generate Preview. 


3 (Conditional) If you get a message stating that your browser prevented pop-up windows from 
appearing, enable pop-ups for this site. 
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fi filereporter.sp.cctec.org/Reports/ReportViewer?stored_report_id=2 Q 


6% Page 1 vy of ¿2 > >> OO & por + 


Y Summary 
Parameters 
Top 10 Folders by File Size 


» Report Data 


Summary Report 


CCTEC 


CCTEC 


Report Date: 12/21/2020 7:56:56 PM 
Generated by: File Reporter 


All reports are structured similarly, with a title page, report parameters, for some report types a 
Top Ten summary, followed by a comprehensive breakdown of the data in the pages that follow. 


Display the Search Window button: Lets you conduct a search within the preview report. 
Print the Report button: Prints the entire preview report. 

Print the Current Page button: Prints the currently displayed page. 

First Page button: Takes you to the first page of the preview report. 

Previous Page button: Takes you to the page that precedes the page you are viewing. 
Page drop-down menu: Lets you advance to a page number by selecting it. 

Next Page button: Takes you to the page that follows the page you are viewing. 

Last Page button: Takes you to the last page of the preview report. 


Export a Report and Save it to the Disk button: Exports the preview report to the file type 
listed in the drop-down menu and lets you view or save it in the new format. 


Export a Report and Show it in a New Window button: Exports the preview report to the file 
type listed in the drop-down menu. 


File Type drop-down menu: Lets you select the file type format to export the report to. 
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Document Navigation: Lists the contents of the report. You can click any item to advance within 
the preview report. 


4 Export, save, or print the preview report. 


Generating a Stored Report 


Generating a report in Stored mode means that the report is saved and available for access for a set 
number of days from the time it is generated. Of course, you can save the report locally where you 
can keep it indefinitely. 

1 From the Report Definitions page, select Generate > Generate Stored Report. 


2 Select Reports > Stored Reports. 


3 Click the report you want to view. 


4 (Conditional) If you get a message stating that your browser prevented pop-up windows from 
appearing, enable pop-ups for this site. 
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fi filereporter.sp.cctec.org/Reports/ReportViewer?stored_report_id=2 Q 


6% Page 1 vó 4) > GS & por » 


Y Summary 
Parameters 
Top 10 Folders by File Size 


» Report Data 


Summary Report 


CCTEC 


CCTEC 


Report Date: 12/21/2020 7:56:56 PM 
Generated by: File Reporter 


All reports are structured similarly, with a title page, report parameters, for some report types a 
Top Ten summary, followed by a comprehensive breakdown of the data in the pages that follow. 


Display the Search Window button: Lets you conduct a search within the preview report. 
Print the Report button: Prints the entire preview report. 

Print the Current Page button: Prints the currently displayed page. 

First Page button: Takes you to the first page of the preview report. 

Previous Page button: Takes you to the page that precedes the page you are viewing. 
Page drop-down menu: Lets you advance to a page number by selecting it. 

Next Page button: Takes you to the page that follows the page you are viewing. 

Last Page button: Takes you to the last page of the preview report. 


Export a Report and Save it to the Disk button: Exports the preview report to the file type 
listed in the drop-down menu and lets you view or save it in the new format. 


Export a Report and Show it in a New Window button: Exports the preview report to the file 
type listed in the drop-down menu. 


File Type drop-down menu: Lets you select the file type format to export the report to. 
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Document Navigation: Lists the contents of the report. You can click any item to advance within 
the report. 


5 Save or print the stored report. 


6.5.2 Generating a Directory Quota Report 


Directory Quota reports specify folders with assigned quota, the amount of quota assigned, and the 
amount of quota consumed. 


NOTE: Quota information is only available if the file system scan policy was configured to collect 
quota information. 


1 Select Reports > Report Definitions. 
2 Click Add. 
3 In the Name field, specify a descriptive name of the report definition. 


4 Select the Directory Quota option and click OK. 


Report Definition Editor - HQ Users Directory Quota Report 


HQ Users Directory Quota Report 


O 


Directory Quota Report 


Report Definition created on 12/2/2020 8:07:05 PM by 
SP\Administrator 


TARGET PATHS FILE MANAGEMENT POLICIES 


Add Remove 


ae 


5 From the Target Paths tab, click Add. 
6 Browse to and select the file paths you want included in the report and click OK. 
7 Click Save. 


8 Generate the report as either a Preview report or a Stored report. 
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For procedures on generating a Preview report, see “Generating a Preview Report” on page 59. 


For procedures on generating a Stored report, see “Generating a Stored Report” on page 61. 
6.5.3 Generating a Storage Cost Report 
Storage Cost reports indicate storage costs according to prices established in the Cost per Unit setting 


of the Report Definition editor. You can use this report to determine which users or groups are being 
irresponsible with network storage practices. 


NOTE: When the report is generated, the monetary symbol that is displayed comes from the local 
Engine/Web server's Windows locale and region settings. For example, if the Windows server 
hosting the engine and Web application is set up using US locale and region, it will show a $ for 
costing displays in the report. 


1 Select Reports > Report Definitions. 
2 Click Add. 
3 In the Name field, specify a descriptive name of the report definition. 


4 Select the Storage Cost option and click OK. 


Report Definition Editor - Atlanta Users Storage Cost Report 


Atlanta U: St Cost Ri t 
anta Users Storage Cost Report cB + 


O t per Unit:* 10 $ 
Storage Cost Report 


Report Definition created on 12/2/2020 8:07:05 PM by 
SP\Administrator 


TARGET PATHS FILE MANAGEMENT POLICIES 


Add Remove 


edhe 


5 In the Unit drop-down menu, select the storage unit value for which you want to establish a 
cost. 


6 In the Cost per Unit field, indicate the cost of the selected storage unit. 
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7 From the Target Paths tab, click Add. 
8 Browse to and select the file paths you want included in the report and click OK. 
9 Click Save. 
10 Generate the report as either a Preview report or as a Stored report. 
For procedures on generating a Preview report, see “Generating a Preview Report” on page 59. 


For procedures on generating a Stored report, see “Generating a Stored Report” on page 61. 


6.5.4 Generating a Comparison Report 


A Comparison report specifies the differences between two selected folders on the network. This is 
useful if you want to verify that servers are hosting the same version of software, library files on 
servers are the same, and so forth. 

1 Select Reports > Report Definitions. 

2 Click Add. 

3 In the Name field, specify a descriptive name of the report definition. 


4 Select the Comparison option and click OK. 


Report Definition Editor - HQ Share Users Comparison Report 


HQ Share Users Comparison Report Results Show unique paths from both targets v 


Comparison Report 


Report Definition created on 12/2/2020 8:07:05 PM by 
SP\Administrator 


TARGET PATHS 


Add Remove 


or | Pe 


5 In the Comparison Results drop-down menu, select an option. 


Show unique paths from both targets: The report indicates the differences in folder and file 
names for the compared target paths. 
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6.6 


6.6.1 


Show paths unique to the first target: The report indicates only the unique folder and file 
names found in the first target path. 


Show paths unique to the second target: The report indicates only the unique folder and file 
names found in the second target path. 


From the Target Paths tab, click Add. 
Browse to and select two shares or folders whose data you want to compare and click OK. 


Click Save. 


O On OD 


Generate the report as either a Preview report or as a Stored report. 
For procedures on generating a Preview report, see “Generating a Preview Report” on page 59. 


For procedures on generating a Stored report, see “Generating a Stored Report” on page 61. 


Permissions Reports 


Reports in this classification include Assigned NTFS Permissions, Permissions by Path, and 
Permissions by Identity. 


Before generating any type of Permissions report, you must first conduct a Permissions scan on the 
volumes or shares you want to report on. 

+ Section 6.6.1, “Generating an Assigned NTFS Permissions Report,” on page 66 

+ Section 6.6.2, “Generating a Permissions by Path Report,” on page 68 


+ Section 6.6.3, “Generating a Permissions by Identity Report,” on page 69 


Generating an Assigned NTFS Permissions Report 


The Assigned NTFS Permissions report indicates the assigned Microsoft file system user permissions 
for all folders and subfolders from a specified path. 

1 Select Reports > Report Definitions. 

2 Click Add. 

3 Inthe Name field, specify a descriptive name of the report definition. 


4 Select the Assigned NTFS Permissions option and click OK. 
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Report Definition Editor - London Users Assigned NTFS Permissions Report 


Name:* London Users Assigned NTFS Permissions Report O Limit Path Depth 


Unformatted: [] O Include Inherited ACEs 


Assigned NTFS Permissions Report 


Report Definition created on 12/2/2020 8:07:05 PM by 
SP\Administrator 


TARGET PATHS FILE MANAGEMENT POLICIES 


Add Remove 


ano 


5 (Conditional) If you want to limit the scope of the report to a set depth in the file structure, click 
the Limit Path Depth check box and specify the depth level. 


For example, if you specify 3, the report lists the file contents of all file paths in the specified 
target paths up to 3 levels in the file structure. 


If you do not specify a path depth, File Reporter will report on all levels of the specified target 
path. 


6 (Conditional) If you don’t want the report to include inherited ACEs (Access Control Entries), 
deselect the Include Inherited ACEs check box. 


7 From the Target Paths tab, click Add. 
8 Browse to and specify the file paths you want included in the report and click OK. 
9 Click Save. 
10 Generate the report as either a Preview report or a Stored report. 
For procedures on generating a Preview report, see “Generating a Preview Report” on page 59. 


For procedures on generating a Stored report, see “Generating a Stored Report” on page 61. 
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6.6.2 Generating a Permissions by Path Report 


The Permissions by Path report indicates the effective permissions to the Microsoft file system 
according to the paths you specify. 

1 Select Reports > Report Definitions. 

2 Click Add. 

3 In the Name field, specify a descriptive name of the report definition. 


4 Select the Permissions by Path option and click OK. 


Report Definition Editor - London Users Permissions by Path Report 


London Users Permissions by Path Report 


matted: (J 


Permissions by Path Report 


Report Definition created on 12/2/2020 8:07:05 PM by 
SP\Administrator 


TARGET PATHS FILE MANAGEMENT POLICIES 


Add Remove 


a 


From the Target Paths tab, click Add. 
Browse to and specify the file paths you want included in the report and click OK. 
Click Save. 


on Q U 


Generate the report as either a Preview report or a Stored report. 
For procedures on generating a Preview report, see “Generating a Preview Report” on page 59. 


For procedures on generating a Stored report, see “Generating a Stored Report” on page 61. 
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6.6.3 Generating a Permissions by Identity Report 


The Permissions by Identity report indicates the effective permissions to the Microsoft file system 
according to the identities you specify. 

1 Select Reports > Report Definitions. 

2 Click Add. 

3 In the Name field, specify a descriptive name of the report definition. 


4 Select the Permissions by Identity option and click OK. 


Report Definition Editor - HQ Users Permissions by Identity Report 


Name:* HQ Users Permissions by Identity Report 


matted: [1] 


Permissions by Identity Report 


Report Definition created on 12/2/2020 8:07:05 PM by 
SP\Administrator 


IDENTITIES 


Add Remove 


eel 


From the Identities tab, click Add. 

Browse to and specify the identities you want included in the report. 
Click OK to close the Identity Browser. 

Click Save to close the Report Definition Editor. 


O on DO WI 


Generate the report as either a Preview report or a Stored report. 
For procedures on generating a Preview report, see “Generating a Preview Report” on page 59. 


For procedures on generating a Stored report, see “Generating a Stored Report” on page 61. 
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6.7 File Data Reports 


Reports in this classification include Filename Extension, Owner, Duplicate File, and Date-Age, along 
with detailed versions of each of these reports. 


Before generating any type of File Data report, you must first conduct a File System scan on the 
shares you want to report on. 

+ Section 6.7.1, “Generating a Filename Extension Report,” on page 70 

¢ Section 6.7.2, “Generating a Detailed Filename Extension Report,” on page 71 

+ Section 6.7.3, “Generating an Owner Report,” on page 73 

+ Section 6.7.4, “Generating a Detailed Owner Report,” on page 74 

¢ Section 6.7.5, “Generating a Duplicate File Report,” on page 75 

+ Section 6.7.6, “Generating a Detailed Duplicate File Report,” on page 76 

+ Section 6.7.7, “Generating a Date-Age Report,” on page 78 

+ Section 6.7.8, “Generating a Detailed Date-Age Report,” on page 79 


6.7.1 Generating a Filename Extension Report 
The Filename Extension report presents data grouped according to filename extension. This report is 


helpful for determining file types that you do not want stored on your network drives. For example, 
you can easily identify who is storing .MP3 or .MOV files. 


NOTE: File extensions in File Reporter are limited to 32 characters. File extensions longer than 32 
characters are considered part of the file name and not as an extension. 


1 Select Reports > Report Definitions. 
2 Click Add. 
3 Inthe Name field, specify a descriptive name of the report definition. 


4 Select the Filename Extension option and click OK. 
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Report Definition Editor - London Users Filename Extension Report 


HQ Users Filename Extension Report 


ted O 


Filename Extension Report 


Report Definition created on 12/2/2020 8:07:05 PM by 
SP\Administrator 


TARGET PATHS FILE MANAGEMENT POLICIES FILTERS 


Add Remove 


a 


5 From the Target Paths tab, click Add. 
6 Browse to and specify the file paths you want included in the report and click OK. 
7 (Optional) Click the Filters tab and set the filters for the report. 


For information on using the filtering capabilities of File Reporter, refer to Appendix A, “Filtering 
for Built-in Reports,” on page 155. 


8 Click Save. 

9 Generate the report as either a Preview report or a Stored report. 
For procedures on generating a Preview report, see “Generating a Preview Report” on page 59. 
For procedures on generating a Stored report, see “Generating a Stored Report” on page 61. 


10 (Optional) Generate a Detailed report on an individual file extension by clicking a file extension 
name in the report. 


6.7.2 Generating a Detailed Filename Extension Report 


A Detailed Filename Extension report is similar to a standard Filename Extension report, except you 
can filter the report to include only the files with the extension types you want. 


1 Select Reports > Report Definitions. 
2 Click Add. 
3 Inthe Name field, specify a descriptive name of the report definition. 


4 Select the Filename Extension Detail option and click OK. 
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Report Definition Editor - HQ Users Filename Extension Detail Report 


Filename Extensions (no leading dot), one per line 
Name:* HQ Users Filename Extension Detail Report 


Unformatted: O 


Filename Extension Detail Report 


ption Report Definition created on 12/2/2020 8:07:05 PM by 
SP\Administrator 


TARGET PATHS FILE MANAGEMENT POLICIES FILTERS 


Add Remove 


Rote 


5 Inthe Filename Extension field, specify the filename extensions you want included in the report 
by listing each on an individual line. Do not precede the filename extension with a period. 


For example: 

mov 

jpg 

tmp 
6 From the Target Paths tab, click Add. 
7 Browse to and specify the file paths you want included in the report and click OK. 
8 (Optional) Click the Filters tab and set the filters for the report. 


For information on using the filtering capabilities of File Reporter, refer to Appendix A, “Filtering 
for Built-in Reports,” on page 155. 


9 Click Save. 
10 Generate the report as either a Preview report or a Stored report. 
For procedures on generating a Preview report, see “Generating a Preview Report” on page 59. 


For procedures on generating a Stored report, see “Generating a Stored Report” on page 61. 
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6.7.3 Generating an Owner Report 


An Owner report groups data according to file owners. If it is determined that certain users are using 
a disproportionate amount of storage, you can see what these users are storing and if they are 
justified in doing so. 

1 Select Reports > Report Definitions. 

2 Click Add. 

3 In the Name field, specify a descriptive name of the report definition. 


4 Select the Owner option and click OK. 


Report Definition Editor - Atlanta Users Owner Report 


Names" Atlanta Users Owner Report 


matted: O 


Owner Report 


Report Definition created on 12/2/2020 8:07:05 PM by 
SP\Administrator 


TARGET PATHS FILE MANAGEMENT POLICIES FILTERS 


Add Remove 


ie 


5 From the Target Paths tab, click Add. 
6 Browse to and specify the file paths you want included in the report and click OK. 
7 (Optional) Click the Filters tab and set the filters for the report. 


For information on using the filtering capabilities of File Reporter, refer to Appendix A, “Filtering 
for Built-in Reports,” on page 155. 


8 Click Save. 

9 Generate the report as either a Preview report or a Stored report. 
For procedures on generating a Preview report, see “Generating a Preview Report” on page 59. 
For procedures on generating a Stored report, see “Generating a Stored Report” on page 61. 


10 (Optional) Generate a Detailed report on an individual owner by clicking an owner’s name in 
the report. 
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6.7.4 Generating a Detailed Owner Report 


74 


A Detailed Owner report is similar to a standard Owner report, except you can specify the users you 
want information on. 

1 Select Reports > Report Definitions. 

2 Click Add. 

3 Inthe Name field, specify a descriptive name of the report definition. 


4 Select the Owner Detail option and click OK. 


Report Definition Editor - Munich Users Owner Detail Report 


A à Munich Users Owner Detail Report ti} See Owners tab below for selected identities. 
Name: i w il 


Owner Detail Report 


Report Definition created on 12/2/2020 8:07:05 PM by 
SP\Administrator 


OWNERS TARGET PATHS FILE MANAGEMENT POLICIES FILTERS 


Add Remove 


# Identity System Owner 


No data to paginate 


ne 


5 From the Owners tab, click Add, then browse to and specify the owners you want in the report 
and click OK. 


6 From the Target Paths tab, click Add, then browse to and specify the file paths you want 
included in the report and click OK. 


7 (Optional) Click the Filters tab and set the filters for the report. 


For information on using the filtering capabilities of File Reporter, refer to Appendix A, “Filtering 
for Built-in Reports,” on page 155. 


8 Click Save. 
9 Generate the report as either a Preview report or a Stored report. 
For procedures on generating a Preview report, see “Generating a Preview Report” on page 59. 


For procedures on generating a Stored report, see “Generating a Stored Report” on page 61. 
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6.7.5 


Generating a Duplicate File Report 


A Duplicate File report indicates duplicate versions of files being stored and their locations. A 
principle objective for any organization determined to limit network storage usage should be the 
elimination of duplicate versions of files. 


NOTE: This Duplicate File report option is generated by comparing filenames and other metadata. 
File Reporter offers a more advanced Duplicate File report generated through content hash 
comparisons. For more details, see Section 6.11.1, “Generating a Content Hashed Duplicate File 
Report,” on page 90. 


1 Select Reports > Report Definitions. 
2 Click Add. 
3 In the Name field, specify a descriptive name of the report definition. 


4 Select the Duplicate File option and click OK. 


Report Definition Editor - Atlanta Duplicate File Report 


Atlanta Duplicate File Report Match Size 


O Match Name 
Duplicate File Ri t 
uplicate File Repor O Match Create Tin 
Report Definition created on 12/2/2020 8:07:05 PM by O Match Modify Time 


SP\Administrator 
Minimum Duplicates 2 9 


TARGET PATHS FILE MANAGEMENT POLICIES FILTERS 


Add Remove 


Mt 


5 Use the check boxes and Minimum Duplicates field to specify the parameters for reporting. 


The more check boxes you select, the more likely it is that File Reporter can identify definitive 
duplicate files. 


Match Size: Specifies that files reported must have duplicate file sizes. This option cannot be 
deselected. 


Match Name: Specifies that files reported must have duplicate names with other files. 
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Match Create Time: Specifies that files reported must have duplicate file creation times with 
other files. 


Match Modify Time: Specifies that files reported must have duplicate file modification times 
with other files. 


Minimum Duplicates: Specifies the minimum number of duplicate files, according to the 
parameters selected above, for inclusion in the report. 


Browse to and specify the file paths you want included in the report and click OK. 


7 (Optional) Click the Filters tab and set the filters for the report. 


For information on using the filtering capabilities of File Reporter, refer to Appendix A, “Filtering 
for Built-in Reports,” on page 155. 


8 Click Save. 


9 Generate the report as either a Preview report or a Stored report. 


10 


1 
2 
3 
4 


For procedures on generating a Preview report, see “Generating a Preview Report” on page 59. 
For procedures on generating a Stored report, see “Generating a Stored Report” on page 61. 


(Optional) Generate a Detailed report on a duplicate file by clicking a specific file name in the 
report. 


6.7.6 Generating a Detailed Duplicate File Report 


A Detailed Duplicate File report is similar to a standard Duplicate File report, except you can specify 
the exact filename to search for, along with exact create and modify times. 


Select Reports > Report Definitions. 
Click Add. 
In the Name field, specify a descriptive name of the report definition. 


Select the Duplicate File Detail option and click OK. 
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Report Definition Editor - HQ Duplicate File Detail Report 


HQ Duplicate File Detail Report Duplicate Criteria 


O O Name 
T Duplicate File Detail Report O a Byles 
Create Time 
Report Definition created on 12/2/2020 8:07:05 PM by O 
SP\Administrator O Modify Time 


TARGET PATHS FILE MANAGEMENT POLICIES FILTERS 


Add Remove 


Target Path 


Ss 


In the Duplicate Criteria region, specify the file name size, and the dates and times that the file 
was created or modified. 


IMPORTANT: When specifying Create or Modify times, the time entered must be exact down to 
the second. If a date range is required, do not enable the Create or Modify criteria here, but use 
the date filters in the Filters tab. For more information on filters, see Appendix A, “Filtering for 
Built-in Reports,” on page 155. 


Browse to and specify the file paths you want included in the report and click OK. 
(Optional) Click the Filters tab and set the filters for the report. 


For information on using the filtering capabilities of File Reporter, refer to Appendix A, “Filtering 
for Built-in Reports,” on page 155. 


Click Save. 


9 Generate the report as either a Preview report or a Stored report. 


For procedures on generating a Preview report, see “Generating a Preview Report” on page 59. 


For procedures on generating a Stored report, see “Generating a Stored Report” on page 61. 
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6.7.7 Generating a Date-Age Report 
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The Date-Age report presents file count data according to when files were created, last accessed, or 
last modified. You can use this report to help you determine which files have not been accessed for a 
given amount of time and then decide whether to delete, archive, or move those files to less 
expensive storage. 

1 Select Reports > Report Definitions. 

2 Click Add. 

3 In the Name field, specify a descriptive name of the report definition. 


4 Select the Date-Age option and click OK. 


Report Definition Editor - HQ Users Date-Age Report 


HQ Users Date-Age Report Date Type Create Time 7 


j: O ve Year y 


Date-Age Report 


Report Definition created on 12/2/2020 8:07:05 PM by 
SP\Administrator 


TARGET PATHS FILE MANAGEMENT POLICIES FILTERS 


Add Remove 


aoe 


5 In the Date Type drop-down menu, select an option. 
Create Time: Reports when files were created. 
Modify Time: Reports when files were last modified. 
Access Time: Reports when files were last accessed. 

6 In the Detail Level drop-down menu, select an option. 


Year: Groups the file count in the report according to the year they were created, last modified, 
or last accessed. 


Month: Groups the file count in the report according to the month they were created, last 
modified, or last accessed. 
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Day: Groups the file count in the report according to the calendar date they were created, last 
modified, or last accessed. 


7 Browse to and specify the file paths you want included in the report and click OK. 
8 (Optional) Click the Filters tab and set the filters for the report. 


For information on using the filtering capabilities of File Reporter, refer to Appendix A, “Filtering 
for Built-in Reports,” on page 155. 


9 Click Save. 
10 Generate the report as either a Preview report or a Stored report. 
For procedures on generating a Preview report, see “Generating a Preview Report” on page 59. 
For procedures on generating a Stored report, see “Generating a Stored Report” on page 61. 
11 (Optional) Generate a Detailed report by clicking a specific year, month, or date in the report. 


Unlike the original Date-Age report that lists the data by file count, the generated Detailed 
report lists individual files. 


6.7.8 Generating a Detailed Date-Age Report 


A Detailed Date-Age report is similar to a standard Date-Age report, except you can specify the exact 
create, modify, or access date parameters. 


1 Select Reports > Report Definitions. 
2 Click Add. 
3 In the Name field, specify a descriptive name of the report definition. 


4 Select the Date-Age Detail option and click OK. 
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Report Definition Editor - Atlanta Shares Detailed Date-Age Report 


Atlanta Shares Detailed Date-Age Report 


matted: D 


Date-Age Detail Report 


Create Time v 


Year = 


Report Definition created on 12/2/2020 8:07:05 PM by 
SP\Administrator 


Enter one or more dates with the format yyyy-mm-dd, 
one per line. 


TARGET PATHS FILE MANAGEMENT POLICIES FILTERS 


Add Remove 


ee 


5 In the Date Type drop-down menu, select an option. 
Create Time: Reports when files were created. 
Modify Time: Reports when files were last modified. 
Access Time: Reports when files were last accessed. 

6 In the Detail Level drop-down menu, select an option. 


Year: Groups the file count in the report according to the year they were created, last modified, 
or last accessed. 


Month: Groups the file count in the report according to the month they were created, last 
modified, or last accessed. 


Day: Groups the file count in the report according to the calendar date they were created, last 
modified, or last accessed. 


7 Inthe Selected Dates field, specify the dates you want. 


This indicates that only the files created, last modified, or last accessed on those dates will be 
included in the report. 


8 Browse to and specify the file paths you want included in the report and click OK. 
9 (Optional) Click the Filters tab and set the filters for the report. 


For information on using the filtering capabilities of File Reporter, refer to Appendix A, “Filtering 
for Built-in Reports,” on page 155. 


10 Click Save. 


11 Generate the report as either a Preview report or a Stored report. 
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6.8 


6.8.1 


For procedures on generating a Preview report, see “Generating a Preview Report” on page 59. 


For procedures on generating a Stored report, see “Generating a Stored Report” on page 61. 


Historic Comparison Reports 


Historic Comparison reports specify the differences between two similar scan types of the same 
target system. For example, if you had a Previous Permissions scan of a Windows share and a 
Current Permissions scan of the same share, you could generate a Historic NTFS Permissions 
Comparison report that would specify the differences in permissions between the two points in time 
that the scans were taken. 


Historic Comparison reports can compare the following: 


+ Baseline scans to Previous scans 
+ Baseline scans to Current scans 


+ Historic scans to Current scans 


Reports in this classification include Historic File System Comparison and Historic NTFS Permissions 
Comparison. 


+ Section 6.8.1, “Generating a Historic File System Comparison Report,” on page 81 


+ Section 6.8.2, “Generating a Historic NTFS Permissions Comparison Report,” on page 83 


Generating a Historic File System Comparison Report 


1 Select Reports > Report Definitions. 
2 Click Add. 
3 In the Name field, specify a descriptive name of the report definition. 


4 Under Historic Comparison, select the File System Comparison option, then click OK. 
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Report Definition Editor - Atlanta Historic File System Comparison Report 


Atlanta Historic File System Comparison Report O Limit Path Depth 


tte O Scans to Compare Current and Previous v 


Historic File System Comparison Report 


QUERY FILTERS DETAIL DISPLAY OPTIONS 
Report Definition created on 12/2/2020 8:07:05 PM by 
SP\Administrator 
Added Entries Files 
Removed Entries Folders 
(um) Modified Entries 


Include entries modified by: 


File Size [] Create Time [] Directory Quota 
Attributes [[] Modify Time 
Owner [L] Access Time 


TARGET PATHS 


Add Remove 


Varia 


5 (Conditional) If you want to limit the scope of the report to a set depth in the file structure, click 


the Limit Path Depth check box and specify the depth level. 


For example, if you specify 3, the report lists the file contents of all file paths in the specified 
target paths up to 3 levels in the file structure. 


If you do not specify a path depth, File Reporter will report on all levels of the specified target 
path. 


From the Scans to Compare drop-down menu, select one of the following options: 


Current and Previous: Compares the Current scan of the storage resource to the Previous scan 
of the storage resource. 


Current and Baseline: Compares the Current scan of the storage resource to the Baseline scan 
of the storage resource. 


Previous and Baseline: Compares the Previous scan of the storage resource to the Baseline 
scan of the storage resource. 


All options appear whether you have scans or not. If you do not have scans, File Reporter will 
generate an empty report. 


In the Query Filters region, specify whether to include the following metadata categories in the 
report: 


Added Entries: If you want the report to list files or folders that have been added since the 
older scan, leave this check box selected. 


Removed Entries: If you want the report to list files or folders that have been removed since the 
older scan, leave this check box selected. 
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Modified Entries: If you want the report to list files or folders that have been modified since the 
older scan, leave this check box selected. 


Files: If you want the report to list files, leave this check box selected. 
Folders: If you want the report to list folders, leave this check box selected. 


8 In the Include entries modified by: region of the Query Filters, specify which of the attributes 
modified between the older and newer scan you want included in the report. 


9 In the Detail Display Options region, identify whether to display the metadata categories 
specified below in the Detail Data section of the report. 


The categories below pertain to the Detail Data section of the report only, and not the Summary 
Data section. 


Added Entries: If you want the report to display this category, whether there are added entries 
to list or not, select this check box. 


Removed Entries: If you want the report to display this category, whether there are removed 
entries to list or not, select this check box. 


Modified Entries: If you want the report to display this category, whether there are modified 
entries to list or not, select this check box. 


10 (Conditional) If you selected the Modified Entries check box, in the Always show modify detail 
for: region, select any of the category options you want displayed in the report whether these 
metadata categories have been changed between the two scans or not. 


By default, the Modified Entries section of the report only shows metadata that has changed. 
The options in this region of the dialog box are to force the display of one or more particular 
metadata properties. 


Any metadata for an entry that File Reporter has determined has changed is displayed in bold 
font. Any optional data that has not changed is displayed in regular font. 


11 Browse to and specify the file paths you want included in the report, then click OK. 
12 Click Save to close the Report Definition Editor. 
13 Generate the report as either a Preview report or a Stored report. 
For procedures on generating a Preview report, see “Generating a Preview Report” on page 59. 


For procedures on generating a Stored report, see “Generating a Stored Report” on page 61. 


6.8.2 Generating a Historic NTFS Permissions Comparison Report 


1 Select Reports > Report Definitions. 
2 Click Add. 
3 In the Name field, specify a descriptive name of the report definition. 


4 Select the Historic NTFS Permissions option, then click OK. 
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Report Definition Editor - Atlanta Users Historic NTFS Comparison Report 


Atlanta Users Historic NTFS Comparison Report O Limit Path Depth 


O Scans to Compare Current and Previous v 


Historic NTFS Permissions Comparison Report 


O Include Inherited ACES 
Report Definition created on 12/2/2020 8:07:05 PM by 
SP\Administrator Include Removed Paths 


TARGET PATHS 


Add Remove 


ae 


5 (Conditional) If you want to limit the scope of the report to a set depth in the file structure, click 


the Limit Path Depth check box and specify the depth level. 


For example, if you specify 3, the report lists the permissions of file contents of all file paths in 
the specified target paths up to 3 levels in the file structure. 


If you do not specify a path depth, File Reporter will report on all levels of the specified target 
path. 


From the Scans to Compare drop-down menu, select one of the following options: 


Current and Previous: Compares the Current scan of the storage resource to the Previous scan 
of the storage resource. 


Current and Baseline: Compares the Current scan of the storage resource to the Baseline scan 
of the storage resource. 


Previous and Baseline: Compares the Previous scan of the storage resource to the Baseline 
scan of the storage resource. 


All options appear whether you have scans or not. If you do not have scans, File Reporter will 
generate an empty report. 


(Conditional) If you want your report to include not only direct permissions, but inherited 
permissions, select the Include Inherited ACEs check box. 


Reporting inherited permissions could make the report significantly larger. 


(Conditional) If you do not want the report to list any paths that have been deleted or removed, 
deselect the Include Removed Paths check box. 


9 Browse to and specify the file paths you want included in the report, then click OK. 
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10 Click Save to close the Report Definition Editor. 
11 Generate the report as either a Preview report or a Stored report. 
For procedures on generating a Preview report, see “Generating a Preview Report” on page 59. 


For procedures on generating a Stored report, see “Generating a Stored Report” on page 61. 


6.9 Trending Report 


Currently, the only report in this classification is the Volume Free Space report. Before generating a 
Volume Free Space report, you must first conduct a Volume Free Space scan on the volumes or 
shares you want to report on. 


6.9.1 Generating a Volume Free Space Report 


The Volume Free Space report lets you view available Windows share disk space over a set amount 
of time. For best results, you should conduct regularly scheduled Volume Free Space scans on 
specific shares. File Reporter then has the data it needs to graph the pattern of free space on the 
share. 

1 Select Reports > Report Definitions. 

2 Click Add. 

3 Inthe Name field, specify a descriptive name of the report definition. 


4 Select the Volume Free Space option and click OK. 


Report Definition Editor - SFO Volume Free Space Report 


SFO Volume Free Space Report Last number of days to include 365 


O 


Volume Free Space Trending Report 


Report Definition created on 12/2/2020 8:07:05 PM by 
SP\Administrator 


TARGET PATHS 


Add Remove 


ne 
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5 In the Last number of days to include field, specify the last number of days you want the report 
to include. 


For example, if you want the report to graph the last month, enter 30. 
The lowest number you can specify is 7. 
6 Browse to and specify the shares you want included in the report and click OK. 
7 Click Save. 
8 Generate the report as either a Preview report or a Stored report. 
For procedures on generating a Preview report, see “Generating a Preview Report” on page 59. 


For procedures on generating a Stored report, see “Generating a Stored Report” on page 61. 


6.10 Unformatted Reports 


File Reporter allows you to generate unformatted reports. In some instances, having an unformatted 
report might be useful for doing extensive sorting and filtering of the report data using a product 
such as Microsoft Excel. 


File Reporter can generate an unformatted report for all built-in report types except for Summary 
reports. 


You can generate unformatted reports by selecting the option in the Add Report Definition dialog 
box or by selecting the Unformatted check box in the Report Definition Editor dialog box. 


6.10.1 Generating Unformatted Reports 


1 Select Reports > Report Definitions. 

2 Click Add. 

3 Inthe Name field, specify a descriptive name of the report definition. 
4 Select the report type you want to generate. 


5 Select Create report as Unformatted. 
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Add Report Definition 


Name:” Unformatted Owner Report 
Unformatted: [@ Create report as Unformatted (for use with Text, Csv, or Xls exports) 
Directory Data File Data 
O Summary O Filename Extension O Filename Extension Detail 
O Directory Quota © Owner O Owner Detail 
O Storage Cost O Duplicate File O Duplicate File Detail 
O Comparison O Date-Age O Date-Age Detail 
Permissions Historic Comparison 
O Assigned NTFS Permissions O File System Comparison 
O Permissions by Path O NTFS Permissions Comparison 


O Permissions by Identity 


Trending Custom Query 


O Volume Free Space O Custom Query Report 


6 Click OK. 


7 Inthe Report Definition Editor, specify the settings and the file paths you want included in the 
report, then click OK. 


8 Click Save. 
9 Generate the report as either a Preview report or a Stored report. 
For procedures on generating a Preview report, see “Generating a Preview Report” on page 59. 
For procedures on generating a Stored report, see “Generating a Stored Report” on page 61. 
10 From the file type drop-down menu, select either XLS, XLSX, Text, or CSV. 
11 Click the Export a Report and Save it to the Disk button. 
12 Select Save File and click OK. 


6.11 Custom Query Reports 


Custom Query Reports are reports that are generated through a series of SQL commands that you 
enter. These commands enable you to generate very specific detail in reports that are not available 
through the built-in report types in File Reporter. 


The SQL commands must be specific to the database (Microsoft SQL Server or PostgreSQL) that your 
deployment of File Reporter is utilizing. 
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NOTE: For details and examples of the supported database functions, tables, and views that you can 
utilize in Custom Query reports, refer to the Micro Focus File Reporter 4.0 Database Schema and 
Custom Queries Guide. 


SQL commands are entered through report editors available from the File Reporter browser-based 
administrative interface and from the Report Designer client tool. 


NOTE: For details on using the report editor in the Report Designer, see Section 11.3, “Designing a 
Custom Query Report,” on page 142. 


TIP: Don't forget to utilize File Query Cookbook as a resource for obtaining SQL commands and 
sample report layouts that have been submitted by the File Reporter community. Both the SQL 
commands and report layouts can be customized as needed. You can access the File Query 
Cookbook directly through the Report Designer interface, or at https:// 
www.filequerycookbook.com. 


1 Select Reports > Report Definitions. 

2 Click Add. 

3 In the Name field, specify a descriptive name for the report definition. 
4 Select Custom Query Report. 

5 Click OK. 


Generating File System Reports 


Custom Query Editor - Google Chrome 


fi filereporter.sp.cctec.org/Reports/CustomQueryEditor?rptid=7 Q 
EDITOR A 
A Include Column Headers 
A 


5 Elena Delimiter , (Comma) 


(CtlS) (Cti-E) 


Query Delimited Text 


a 


Record Limit 100 


Drag a column here. 


No data to display 


No data to paginate 


6 Enter the SQL commands according to what information you want included in your report. 


As you enter commands, you can click Execute to get a preview in the bottom portion of the 
editor of how the report will appear. 

The Row Limit setting does not limit the size of the report. Instead, it limits how much can be 
previewed. 


Generating File System Reports 89 


Custom Query Editor - Google Chrome = O x 
fi filereporter.sp.cctec.org/Reports/CustomQueryEditor?rptid=7 Q 
EDITOR A 


Include Column Headers 
q > are 
Save Execute Delimiter , (Comma) x 
(CtlS) (Cti-E) 


Query Delimited Text 


4 wiin 

2 x(filename_extension, size, category) AS (SELECT sd.filename_extension, 

3 sd.size, 

4- CASE WHEN sd.filename_extension IN ('lan', 'ncp', 'nlm', ‘nlk', ‘vlm') THEN 'Novel 
5 FROM srs.current_fs_scandata AS sd 

É WHERE (sd.fullpath LIKE '\\sp.cctec.org\DFS\HQ\HQShare\%' ESCAPE '#') AND 
(sd.path_type = 1)) 


9 | SELECT 
10 x.category, 
11 Sum(x.size) AS cat size. 


a mum v 


A 


Record Limit 100 


v 


# category cat_size file_count cat_size_strir 
Configuration 
1 Files 59832 1 58.43 KB 
2 | Document 1331905 9 127MB 
Files : 


Page 1 of 1 (8 items) O 


7 When you are satisfied with the report and the previewed results, click Save. 


8 Close the Custom Query Report Editor. 
9 Select Reports > Report Definitions. 


10 Select the Custom Query Report you just saved and generate the report as either a Preview 
report or a Stored report. 


For procedures on generating a Preview report, see “Generating a Preview Report” on page 59. 


For procedures on generating a Stored report, see “Generating a Stored Report” on page 61. 


6.11.1 Generating a Content Hashed Duplicate File Report 


+ “Using the Query Editor” on page 91 
+ “Using the Report Designer” on page 93 


A Content Hashed Duplicate File report provides more advanced duplicate file detection over the 
Duplicate File built-in report which compares only filenames and metadata. 
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With the introduction of File Reporter 4.0, a new scanning option allows for Agents to produce a 
content based hash for specific files. These hashes can then be compared to identify duplicate files. 


NOTE: For information on the content based hashing option, see Section 5.4, “Creating Scan 
Policies,” on page 38. 


Through filequerycookbook, you can copy and paste the Content Hashed Duplicate File Report 
custom query into the Query Editor and export a report layout into the Report Designer. This custom 
query and associated report identifies duplicate files based on hash comparisons and the parameters 
you set. 


Prerequisites 


+ Create a file system scan policy for each of the target paths on which you want to report. 


+ With the Generate content file hashes option selected in the Scan Policy Editor of each scan 
policy, conduct a file system scan on each target path. 


+ Install the Client Tools. 


The Client Tools include the Query Editor and the Report Designer that will be used in these 
procedures. 


+ Decide how you want the report to be generated and follow the applicable procedures. 


+ To generate a .CSV file that you can take into Microsoft Excel for customized searching and 
presentations or to import as a workload file in the File Dynamics Data Owner Client, you 
can copy or create an SQL query either with the browser based query editor covered in 
“Using the Query Editor” on page 91, or with the query editor in the Report Designer 
covered in “Using the Report Designer” on page 93. 


+ To generate the report using the Report Designer and export the report as either a .PDF, 
.HTML, .MHT, .RTF, .DOCX, .XLS, .XLSX, .CSV, Text, or Image file, proceed with “Using the 
Report Designer” on page 93 


Both the Query Editor and the Report Designer options provide the ability to generate a 
.CSV file, but for efficiency and capabilities, Micro Focus recommends that .CSV files be 
generated using the Query Editor option. 


Using the Query Editor 


1 Select Reports > Report Definitions. 
2 Click Add. 
3 In the Name field, specify a descriptive name for the report definition. 


4 Select Custom Query Report. 
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Custom Query Editor - Google Chrome = O x 


fi filereporter.sp.cctec.org/Reports/CustomQueryEditor?rptid=7 Q 
EDITOR A 
H Include Column Headers 
A 


Save Execute Delimiter , (Comma) - 


(CtS) (Ct-E) 


Record Limit 100 


Drag a column here. 


No data to paginate 


u 


Using File Query Cookbook located at https://www.filequerycookbook.com, locate and 
download the “Content Hashed Duplicate File Report.” 


The file is saved as zipped file. 


m 


Unzip the downloaded file and open it in a text editor such as Notepad++. 


N 


From the text editor, copy the custom query and past it into the Query Editor. 


00 


In the line beginning with WHERE, edit the UNC paths so that they are specific to the content file 
hashed shares on which you want to report. 


The custom query only includes two paths so if you want more, extend the line to include more 
paths by adding srs. path_hash('\\server\share\path' ) to the comma delimited 
sd.fullpath_hash IN portion of the where clause for each desired path. 


wo 


(Conditional) At the bottom of the custom query, modify the q.item_count and q.size 
settings to the minimum number of duplicates and file sizes (in bytes), respectively, to include in 
the report. 


10 Click Execute to get a preview in the bottom portion of the editor of how the report will appear. 
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11 
12 
13 
14 


15 
16 
17 


a filereporter.sp.cctec.org/Reports/CustomQueryEditor?rptid=7 


A > Include Column Headers 


Save Execute Delimiter (Comma) X 
(Ctl-S) (Ctl-E) 
Query Delimited Text 
1 |WLIH 
2 root_path(fullpath, fullpath_hash, ns_left, ns_right, path_type, scan_id) AS (SELECT sd.- 
sd.fullpath_hash, 
4 sd.ns_left, 
5 sd.ns_right, 
6 sd.path_type, 
7 sd.scan_id 
8 FROM srs.scan_data AS sd 
9 INNER JOIN srs.scans AS s ON s.id = sd.scan_id 
10 WHERE (sd.fullpath_hash IN (srs.path_hash('\\srs-ml.sp.cctec.org\Shares'), srs.path_l 
11 (sd.path_type = 2) AND 
12 » 


Record Limit 100 ô 


v 


Page 1 of 1 (100 items) ® 


Custom Query Editor - Google Chrome = ml x 


EDITOR a 


# fullpath size create_time modify_time access_tim name item_count total_size c< 
\\srs- 
m1.sp.cctec 2020-09- 2015-07- 2020-09- 
1 Visual 1081656 21 01 21 msdia140.dll 2 2163312 (_ 
Chidin 47-290-Fa 99-£0-9N 47-20-Fa 


a 


X 


When you are satisfied with the report and the previewed results, click Save. 

Close the Custom Query Report Editor. 

Select Reports > Report Definitions. 

Select the Custom Query Report you just saved and generate the report as a Stored report. 
For procedures on generating a Stored report, see “Generating a Stored Report” on page 61. 
From the Reports menu, select Stored Reports. 

Click the download icon associated with the new report. 

Save the report to a desired location. 


From here you can open the .CSV file into Microsoft Excel and sort through the report data as 
desired. If you have Micro Focus File Dynamics, you can import the .CSV file as a workload. 


Using the Report Designer 


This option lets you utilize both the custom query and the associated report layout design for the 
“Content Hashed Duplicate File Report” from filequerycookbook.com. 
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NOTE: A detailed discussion of the Report Designer, along with procedures for familiarizing yourself 
with the interface are available in Chapter 11, “Using Report Designer,” on page 137. 


1 Using File Query Cookbook located at https: //www.filequerycookbook.com, locate and 
download the “Content Hashed Duplicate File Report.” 


The file is saved as zipped file. 
2 Unzip the downloaded file and open the .SQL file in a text editor such as Notepad++. 
You will eventually paste this custom query into the Query Editor. 


3 From the Start menu, launch the File Reporter 4.0 Report Designer. 


Login 


Web Service URI |https://filereporter.sp.cctec.org/ 
User Name sp\administrator 


Password Password 


4 Enter the login credentials and click Login. 


Y sh&xS 2 ea Wy 
New Custom Rename Copy Delete Refresh Edit Query Design Report Clear Report Visit Community Access Online 
Query Report Layout Layout Portal Templates 
Manage Edit Online Resources ÉS 
Report Name Report Type |Report Owner Last Modified Id 
Y No... afc = [Unknown] afc 
> 
Find Acces DB Files Custom Query sp\administrator 12/3/2020 6:56: 3 
E Home Folder Summary Custom Query sp\administrator 12/3/2020 6:57:... 4 


Y | [Report Type] = ‘Custom Query Edit Filter 


All of your saved Custom Query reports are listed. 
5 Click New Custom Query, give it a name, then click Create. 


The Report Designer Query Editor is launched. 
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Query Editor - new 1 = O x 


E Main 


H [2 fay SOL Text Editor = ES ee 


[7] 52] Query Builder 


Save Execute Reset All Refresh Design 
Query [v] [El Query Results Dock Panels Schema Layout 
SQL Query View Schema Options Report Designer S 
SQL Query Text x 
1| 
SQL Query Builder z 
y | Ĝ Main SQ Main 
Expressions 
as [o]! E Objects 


0-0-0-0 


Visible Expression Colu... Sort Type Sort Order Aggregate Grouping C 
| 


SQL Query Builder SQL Query Results 


Records Loaded: 0 


From the text editor you used in Step 2, copy the custom query and past it into the Query Editor. 


7 In the line beginning with WHERE, edit the UNC paths so that they are specific to the content file 
hashed shares on which you want to report. 

The custom query only includes two paths so if you want more, extend the line to include more 
paths by adding srs.path_hash('\\server\share\path' ) to the comma delimited 
sd.fullpath_hash IN portion of the where clause for each desired path. 


(Conditional) At the bottom of the custom query, modify the q.item_count and q.size 
settings to the minimum number of duplicates and file sizes (in bytes), respectively, to include in 
the report. 


Click Execute to get a preview in the bottom portion of the editor of how the report will appear. 
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Query Editor - new 1 


(q.size > 0) AND 
(q.item_count >= 2) 


E Main 
= 
Y] {gay SQL Text Editor = ES EE] 
Y] (2 Query Builder 
Save Execute e Reset All Refresh Design 
Query [V] E Query Results Dock Panels Schema Layout 
SQL Query View Schema Options Report Designer 
SQL Query Text x 


31 srs.byte_string(CAST((q.total_size - q.size) AS BIGINT)) AS wasted_space_string 
32 FROM 
3 q 
34 WHERE 


SQL Query Results - Limited to 10,000 Records x x 
Drag a column header here to group by that column p 
fullpath | size | create_time | modify time | access_time name item_count | total_size content_ha... |size_string | total_size_s... | wasted_spa...| wasted_spa... 
1081656 2020-09-21... 2015-07-01... 2020-09-21... msdia140.dil 2 2163312 00721b85b... 1.03 MB 2.06 MB 1081656 1.03 MB [a] 
\\srs-m1.sp... 1081656 2020-09-21... 2015-07-01... msdia140.dil 2 2163312 00721b85b... 1.03 MB 2.06 MB 1081656 1.03 MB 
\\srs-m1.sp. 31592 2020-09-21... 2019-04-13... Microsol 3 94776 02b62eac1... 30.85 KB 92,55 KB 63184 61.7 KB 
\\srs-m1,sp. 31592 2020-09-21... 2019-04-13... Microsol 3 94776 02b62eac1... 30.85 KB 92.55 KB 63184 61.7 KB 
\\srs-m1.sp... 31592 2020-09-21... 2019-04-13... Microsoft... a 94776 02b62eac1... 30.85 KB 92,55 KB 63184 61.7 KB 
\\srs-m1.sp... 20021 2020-09-21... 2019-09-18... 2020-09-21... as90.xs! 2 40042 037831bb4... 19.55 KB 39.1 KB 20021 19.55 KB 
\\srs-m1.sp.. 20021 2020-09-21... 2019-06-03... 2020-09-21... as90.xsI 2 40042 037831bb4... 19.55 KB 39.1 KB 20021 19.55 KB 
\\srs-m1.sp.. 637 2020-09-21... 2019-04-13... 2020-09-21... MobileFor... 2 1274 042c7fb844... 637 bytes 1.24 KB 637 637 bytes 
\\srs-m1.sp... 637 2020-09-21... 2015-07-06... 2020-09-21... MobileFor... 2 1274 042c7fb844... 637 bytes 1.24 KB 637 637 bytes 
\\srs-m1.sp... 18624 2020-09-21... 2019-04-13... 2020-09-21... api-ms-win... 2 37248 057b0483f... 18.19 KB 36.38 KB 18624 18.19 KB 
\\srs-m1.sp... 18624 2020-09-21... 2019-04-13... 2020-09-21... api-ms-win... 2 37248 057b0483f... 18.19 KB 36.38 KB 18624 18.19 KB E] 
SQL Query Builder SQL Query Results 
Records Loaded: 1,078 
10 Click Save. 
11 Click Design Layout. 
Report Designer Print Preview 
===] 2 x Zoom Out 
ea & & XS 8 on See es ness a omen A 
oom ~ 
Open... Save Refresh Data Download EditQuery Cut Copy Paste Undo Redo [975 -|B J Layout Windows Scripts 
v Bindings All Data Y {v Q Zoomin v 
Report Report Data Edit Zoom View Scripts S 
Toolbox aa Custom Per | Field List oF x 
Bim 1 1 1 2 1 3 1 4 1 5 1 8 Ú ML FF Report Data 
Standard Controls ^ > FE Query Results 
De Pointer E 
A Label 
M Check Box 
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: GFieia List BB Report Explorer 
E Properties o # x 


| Show Footer 


CustomQueryReportBase Report ~ 


CustomQueryReportBase { Paperkind: Letter } Record Count: 0 


Group and Sort 
III] ss: cose 
Mi AddaGroupy Ya AddaSort” X Delete € MoveUp © Move Down 
all Chart Field Name [Sort Order | Show Header 
> Cross Tab 
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Å Partial query results in use 
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Border Color O-|0 
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Border Width -— |1 ¿[ou 
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Font Times New Roman ~| © 
Background Color 


Gets or sets the control's background color. 


100% -— + 


12 Click Open. 
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13 Locate the .REPX file that you saved and unzipped in Step 2 and click Open. 
The layout template appears in the Report Designer. 
14 Click Download All Data. 
15 In the subsequent dialog box, click Yes. 
This runs the query in the database and loads data into the report template. 
16 Click Print Preview to review the report findings. 


Note how the hashes are listed with a total number for each and the location of each, meaning 
the total number of duplicate files and their locations. 


17 Save the report by doing one of the following: 


+ From the Export To drop-down menu, select the file type you want to save the report 
layout to. 


+ Click Save Report to save the report as a .PRNX file that you can open in the Report Viewer 
and if you want later, export the report to the desired file type. 


Generating Microsoft 365 Reports 


Once Agent365 has scanned the data and associated permissions for Microsoft 365 file repositories, 
including OneDrive for Business, SharePoint Online document libraries, and Teams document 
libraries, you can use the pre-built custom queries and associated report layouts in 
filequerycookbook.com to generate reports. 


Prerequisites 


¢ Install and configure Agent365. 
+ Scan the tenant. 

For procedures, see Section 5.18, “Scanning Your Microsoft 365 Tenant,” on page 48. 
+ Install the Client Tools. 


The Client Tools include the Query Editor and the Report Designer that will be used in these 
procedures. 


a 


Using File Query Cookbook located at https://www.filequerycookbook.com, locate and 
download one of the custom queries and associated reports for Microsoft 365. 


The file is saved as zipped file. 
2 Unzip the downloaded file and open the .SQL file in a text editor such as Notepad++. 
You will eventually paste this custom query into the Query Editor. 


3 From the Start menu, launch the File Reporter 4.0 Report Designer. 
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Login 


Web Service URI https://filereporter.sp.cctec.org/ 


User Name sp\administrator 


Password Password 


4 Enter the login credentials and click Login. 


[E Main 


O taxs vi BB a y 


New Custom Rename Copy Delete Refresh Edit Query Design Report Cl 
Layo! 


ear Report Visit Community Access Online 
Query Report Layout Portal Templates 
Manage Edit Online Resources o 
Report Name = | Report Type a |Report Owner |Last Modified — [ld 
Y No... afc [Unknown] afc = 


Find Acces DB Files 


Custom Query sp\administrator 12/3/2020 6:56: 


mr 
m 


Home Folder Summary 


Custom Query sp\administrator 12/3/2020 6:57:... 


[Y] [Report Type] = ‘Custom Query” Edit Filter 


All of your saved Custom Query reports are listed. 
5 Click New Custom Query, give it a name, then click Create. 
The Report Designer Query Editor is launched. 
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Query Editor - new 1 


== x 
E Main 
[2 ¡ag SQL Text Editor ml = Ju} 
a- [7] (22) Query Builder S e 
Save Execute a Reset All Refresh Design 
Query [v] [El Query Results Dock Panels Schema Layout 
SQL Query View Schema Options Report Designer $ 
SQL Query Text x ” 
1 
SQL Query Builder ł x 
g| @ Main E-Q Main 
i Expressions 
[aja L-E Objects 
Visible Expression Colu... Sort Type Sort Order Aggregate O Grouping C 


SQL Query Builder SQL Query Results 


Records Loaded: 0 


6 From the text editor you used in Step 2, copy the custom query and past it into the Query Editor. 


7 (Conditional) If there are target paths or other modifications that need to be made for your 
environment, follow the procedures for the “recipe.” 


8 Click Execute to get a preview in the bottom portion of the editor of how the report will appear. 


Query Editor - duplicate file -tenant 


= [m] x 
Ez] Main 
T= = 
Y] ¡fa SQL Text Editor =| Ess] fa) 
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Save Execute __ Reset All Refresh Design 
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SQL Query Text x - 
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3 di.web_url, 
4 di.size, 
5 srs.byte_string(di.size) AS size_string, 
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SQL Query Results - Limited to 10,000 Records . ox 
Drag a column header here to group by that column p 
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Galileo-ReportViewer-4,0.0-x64-34-2.exe https://condreycorprpl-my.sharepoint.com/personal/gna... 47444616 | 45,25 MB Gary Nance Gary Nance 2 89bb5145... +] 


SQL Query Builder SQL Query Results 


Records Loaded: 46 


9 Click Save. 
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10 Click Design Layout. 


11 
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14 


15 
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Locate the . REPX file that you saved and unzipped in Step 2 and click Open. 


The layout template appears in the Report Designer. 
Click Download All Data. 


In the subsequent dialog box, click Yes. 


This runs the query in the database and loads data into the report template. 


Click Print Preview to review the report findings. 


Save the report by doing one of the following: 


+ From the Export To drop-down menu, select the file type you want to save the report 


layout to. 


+ Click Save Report to save the report as a .PNRX file that you can open in the Report Viewer 


and if you want later, export the report to the desired file type. 


6.12 Micro Focus File Dynamics Policy Reports 


100 


In most reports, you browse to and specify a file path for the report through the Target Paths tab. If 
you have Micro Focus File Dynamics managing your organization's user and collaborative storage, 

you can have File Reporter report on the storage according to the target paths of the File Dynamics 
policies, rather than through a specific file path. 


IMPORTANT: File Reporter 4.0 supports File Dynamics 6.0 and above. 
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The advantages to specifying a File Dynamics policy rather than a file path is that a policy can include 
many different target paths. For example, in a large organization that utilizes File Dynamics” load 
balancing capabilities, a single policy might have 10 or more target paths. If you chose to specify the 
paths through the Target Paths tab, you would need to list all 10 paths. But if you have each of the 
target paths listed in a single policy, through the File Management Policies tab, all you need to do is 
add the single policy. 


Another important advantage is that File Reporter reads the associated policy target paths each time 
a report is generated, so that it dynamically responds to changes in assigned target paths for File 
Dynamics policies. 


NOTE: Procedures for integrating File Reporter with File Dynamics are included in Section 4.4, 
“Integrating with File Dynamics,” on page 33. 


You can specify policies for all File Reporter reports with the exception of Comparison reports, 
Permissions by Identity reports, and Volume Free Space reports. 


Scheduling Reports 


You can generate reports on a one-time or regularly scheduled basis. 


1 Select Reports > Report Definitions. 
2 From the list of report definitions, select one that is not scheduled. 


3 Select Schedule > Edit Schedule. 
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Schedule for Atlanta Shares Detailed Date-Age Report 


SCHEDULE START 


Engine Local Time:* 12:00 AM 


<> 


Engine Local Start Date:* 6/15/2020 v 


SCHEDULE RECURRENCE 


O Once 

O Daily 

(O) Weekly Friday y 
O Monthly 


Day 


The 


Engine Local Time: Specify the time that you want the report to generate. 


The time you select should be based on the time zone where the Engine is located and not the 
workstation where you are accessing the Web application. 


Engine Local Start Date: Specify the date when you want the report schedule to take effect. 


Be aware that entering a date does not mean that the report generates on that date. If the 
Engine Local Start Date is set for today, which is a Monday, but the Schedule Recurrence setting is 
set for Weekly on Sunday, the report does not generate until Sunday. 


Once: Select this option to schedule the report to be generated only once. 

Daily: Select this option to schedule the report to be generated daily. 

Weekly: Select this option and specify a weekday to generate the report. 

Monthly: Select this option and specify a day to generate the report each month. 
4 Specify the scheduling parameters and click OK. 


The new schedule is displayed in the Schedule column of the Report Definitions page. 
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6.15 


6.16 


Editing a Scheduled Report 


1 Select Reports > Report Definitions. 

2 From the list of report definitions, select one whose schedule you want to edit. 
3 Select Schedule > Edit Schedule. 

4 Make the schedule changes you want. 

5 Click OK. 


Clearing a Schedule on a Scheduled Report 


1 Select Reports > Report Definitions. 

2 From the list of report definitions, select one whose schedule you want to clear. 
3 Select Schedule > Clear Schedule. 

4 When the confirmation screen appears, click Yes. 


The status of the report definition appears in the Schedule column as Not Scheduled. 


Copying a Report Definition 
To save time in creating a new report definition and its associated properties, you can copy an 
existing report definition. 
When you copy a built-in report, the following properties are included: 
+ Report Parameters 
+ Report Targets Paths 
+ Report Identity Targets 


¢ Filters 


+ File Dynamics Policies 
When you copy a Custom Query report, the following properties are included: 


+ SQL Query 
+ Report Layout 


NOTE: Copying a report definition does not copy the content in the Description field, nor does it copy 
the report schedule. 


1 Select Reports > Report Definitions. 
2 From the list of report definitions, select one that you want to copy. 


3 From the taskbar, click Copy. 
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Copy Report Definition 


Source 


Target Copy of HQ Share and HQ Users Comparison Report 


4 Click Copy. 


The new report definition is added to the list of report definitions with the name Copy of 
preceding the name of the original report definition. 


5 Select the copy of the report definition. 


6 From the taskbar, select Rename. 


Rename Report Definition 


New Name Copy of HQ Share and HQ Users Comparison Report 


7 In the New Name field, specify a name for the new report definition, then click Rename. 


8 From the taskbar, select Schedule > Edit Schedule. 

9 Set the scheduling parameters for the new report definition, then click OK. 
10 From the taskbar, click Edit. 
11 In the Description field, enter a new description. 
12 Click Save. 


6.17 Viewing Reports in Progress 


When you generate large reports, you can view the progress in the Reports in Progress page. 


1 Select Reports > Reports in Progress. 
2 Click Refresh. 


When the report disappears from the list, the report generation has completed. 
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6.18 Troubleshooting Reports 


If there is potential for a reporting problem, File Reporter provides notifications to help resolve the 
issue. The following points might also be helpful. 
1 Verify that a scan exists for the storage resources you want to report on. 


2 If your reports include too much data to be useful, narrow the scope of the report by 


implementing filters. For more information, see Appendix A, “Filtering for Built-in Reports,” on 
page 155. 
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7 Content Scanning and Reporting 


In addition to generating file system, permissions, and trending reports, File Reporter customers also 
have the ability to analyze their files based on content. By analyzing content, organizations can 
locate files containing confidential, sensitive, and personal information that should be given 
restricted access, moved to a more secure location, or deleted. 


All File Content procedures are performed through the File Content menu options. 


7.1 Creating File Content Classifications 


File content classifications are needed by File Reporter as a search parameter. For your convenience, 
File Reporter includes three classifications and severity levels. You can modify this list by editing the 
settings or creating your own classifications. 


7.1.1 Creating a New Classification 


1 Select File Content > Classifications. 


2 Click Add. 


Classification 


Update Cancel 


3 In the Classification field, enter a name. 
For example, Private. 

4 From the Level field, specify a severity level for the new classification. 
For example, 400. 


5 In the Description text box, enter a description for the new classification. 
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For example, High-risk private information, not for public disclosure. 
6 Click Update. 


7.1.2 Editing a Classification 


1 Select File Content > Classifications. 

2 Select the classification you want to edit. 
3 Click Edit. 

4 Edit the fields. 

5 Click Update. 


7.2 Creating File Content Categories 


Categories are an additional way of refining your search parameters. For your convenience, File 
Reporter includes three standard categories. You can modify this list by creating your own 
classifications. 


7.2.1 Creating a New Category 


1 Select File Content > Categories. 
2 Click Add. 


Category 


Update Cancel 


3 In the Category field, enter a name. 
For example, National ID. 

4 In the Description text box, enter a description for the new category. 
For example, US SSNs as well as other national ID schemes. 

5 Click Update. 
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7.2.2 Editing a Category 


1 Select File Content > Categories. 

2 Select the category you want to edit. 
3 Click Edit. 

4 Edit the fields. 

5 Click Update. 


7.3 Creating Search Patterns 


Search patterns specify the conditions for the content scanning, along with how you want to classify 
and categorize the results. 


File Reporter utilizes regex search strings for conducting content scanning. Regex is short for “regular 
expression,” a special text string describing and defining a search pattern. Regex search strings are 
ideal for locating files containing specified patterns (e.g. Social Security numbers, credit card 
numbers, etc.) or other user-defined patterns. 


7.3.1 Creating a New Search Pattern 


1 Select File Content > Search Patterns. 
2 Click Add. 


Search Pattern 


Update Cancel 


3 In the Name field, enter a descriptive name for the search pattern. 

For example, Social Security US - High. 

Names are restricted to A-Z, a-z, 0-9, space, - (hyphen), and_ (underscore). 
4 From the Classification drop-down menu, select a classification. 


5 From the Category drop-down menu, select a category. 
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6 From the Match Confidence drop-down menu, select either Low, Medium, or High. 


These designations allow you to indicate your confidence in the search pattern. Selecting High 
does not necessarily make the match confidence better than selecting Low. It simply indicates 
your confidence in results of the search, based on the depth of the Regex search string. For 
example, a search for all Social Security numbers might be Low, while a search for a particular 
Social Security number specified in the regex string would be High. 


In the Regex Options drop-down menu, select any applicable options. 


For an explanation of these options, we recommend referring to this document (https: // 
docs.microsoft.com/en-us/dotnet/standard/base-types/regular-expression-options) published 
by Microsoft. 


In the Search String text box, enter or paste the search string. 


Note that this version of File Reporter does not yet include an interface for developing regex 
search strings. 


For basic information and tutorials on compiling regular expression search strings, see the 
following sites: 


+ https://regexone.com 
¢ https://www.regular-expressions.info/tutorial.html 
+ https://www.rexegg.com 


For cases where different regex engines or languages are mentioned, note that this version of 
File Reporter makes use of the C# (.NET) regular expression variant. 


Additionally, we will provide a variety of regex search strings on filequerycookbook.com (https:/ 
/www.filequerycookbook.com). 


9 In the Description text box, enter a description of the search pattern. 


Search Pattern 


Social Security US - High 


Restricted > 
Pil X 
fidence:* High e 
tior None > 


Y1+CNMNsSHADI+CNANIHAD1+Ab)01230MU5+)678912191UMs+09N.Ms+399991078CMMs+HO5CMNNAs+11201021666/000/Ad2D1(3K- 
Of4)\d{4}\b 


Search string that looks for the pattern of a Social Security number but leaves out known numbers that are not in circulation. 


Update Cancel 


10 Click Update. 
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7.3.2 Editing a Search Pattern 


1 Select File Content > Search Patterns. 

2 Select the search pattern you want to edit. 
3 Click Edit. 

4 Edit the fields. 

5 Click Update. 


7.4 Creating Job Definitions 
Ajob definition specifies the file system paths where the content scanning will take place, the search 


patterns that will be applied, the filters for the search, and where the content scanning results will 
be stored. 


7.4.1 Creating a New Job Definition 


1 Select File Content > Job Definitions. 
2 Click Add. 


Job Definition 


TARGET PATHS SEARCH PATTERNS FILTERS 


Update Cancel 


3 In the Name field, enter a descriptive name for the job definition. 
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4 From the Result Type menu, select from the following options: 


+ Database: This option saves the results of the content scan to the database, where you can 
use it to generate a report using the Report Designer. Having the scan in the database also 
allows you to search and report utilizing the established classifications and categories. 


+ File: This option saves the results of the content scan as a file in the Search Results 
share. You can access all saved files through the Search Results page. 


5 From the Target Paths tab, click Add. 


Scan Data Browser - File System Data 


* EE sp.cctec.org = 
O f= Wsrs-m1.sp.cctec.orglrefs-share 


X go Fe Wsrs-m1.sp.cctec.orgiShares 


> [) Atlanta 

> C] j Home 

> () a¿sro 

> (O itest 

f= \\srs-m1.sp.cctec.org\Shares2 
f= \\srs-m1Lsp.cctec.org\test-1 
F= \\srs-m1.sp.cctec.org\test-10 
F= \\srs-m1.sp.cctec.org\test-100 


F= \\srs-m1L.sp.cctec.org\test-101 


OOODOO 


f= \\srs-m1.sp.cctec.org\test-102 


b MI Se erm en crtar armitart-107 


6 Select the targets where you want the file content to be scanned. 


IMPORTANT: File paths appear in the Scan Data Browser - File System Data dialog box only if 
the paths have had a previous file system scan. If the path you want does not appear in the 
dialog box, you must first conduct a file system scan on the path. 


7 Click OK. 
8 Click the Search Patterns tab. 
9 Click Add. 
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Search Patterns Browser 


C] Name Category Classification 
C] Social Security US - High Pll Restricted 
O Social Security US - Low Pll Restricted 


10 From the Search Pattern Browser, specify your search patterns and click OK. 
11 Click the Filters tab. 
12 In the Maximum File Size field, specify the size of files that will not be scanned for content. 


For example, large files such as ISO files should probably not be scanned. If you do not enter a 
setting in this field, all files in the file path will be scanned. 


13 In the File Extensions text box, specify the file types that you want scanned. 


If you do not specify file extensions, all files in the file path will be scanned. 
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Job Definition 


Name” | US Social Security Atlanta Users Result e" Database, File v 


TARGET PATHS SEARCH PATTERNS FILTERS 


Maximum File Size: OS MB (Value of O is unlimited size) 


File Extensions pptx 


Enter filename extensions, one per line, without a leading period. 


Update Cancel 


14 Click Update to save the job definition settings. 


7.4.2 Editing a Job Definition 


1 Select File Content > Job Definitions. 

2 Select the job definition you want to edit. 
3 Click Edit. 

4 Edit the fields. 

5 Click Update. 


7.5 Viewing Jobs in Progress 


You can view the status of file content scanning jobs in progress by selecting File Content > Jobs in 
Progress. 
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7.6 Viewing Scanned Data Jobs 


1.7 


You can view a list of file content scan jobs by selecting File Content > Scan Data. 


E 
i 
i 
pif 
pj 
i 
á 


Viewing Search Results 


For those job definitions where the Result Type setting is set to File, you can download the file 
content scan file from the Search Results page. 


File Reporter outputs the file as a CSV file so that if you desire, you can import the file into the Micro 
Focus File Dynamics Data Owner Client where a Data Owner can perform remediation work. 
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File Reporter 4.0 


File Content Search Results 


Job Status File Sue 


Completed 


521 bytes 9/14/2020 1:13:41 PM 


7.8 Viewing AgentFC Configuration Registrations 


You can view the version and the last heartbeat for each deployed AgentFC by selecting File Content 
> Agents. 


File Reporter 4.0 Main~ File Systems ~ File Content ~ 


Governance»  Micrasoft365~ Reports ~ 


Configuration ~ 


BsP\administrator 
o 'S Refresh 


File Content Scan Agents 


Version Last Heartbeat OS Version Tika Version OCR 
[es Windows Server 2019 openjdk version "11.0.7" 2020} 
11/30/2020 7:53:5: 

e Standard (Build 17763) 


OpenJDK Runtime Environ 
OpenJDK 64-Bit Server VM 


mer] Apache Tika 1.24.1 Ready 
Release 1809 


Create Filter 


Copyright 2020 Condrey Corporation 
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8.1 


Performing Other Administrative Tasks 


This section provides procedures for performing administrative tasks not covered in the previous 


sections. 


+ 


+ 


+ 


+ 


+ 


+ 


Section 8.1, “Stopping and Restarting Services,” on page 117 

Section 8.2, “Using Folder Summary,” on page 118 

Section 8.3, “Considerations for Reporting on NAS Devices,” on page 119 
Section 8.4, “Changing the Default Path for Stored Reports,” on page 120 
Section 8.5, “Changing the Life Span of Stored Reports,” on page 121 


Section 8.6, “Resetting the Proxy User Password,” on page 121 


Stopping and Restarting Services 


Use the Configuration Dashboard to stop and restart the Engine, Web Application, Web Service, Web 
Site, and Application Pool. 
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Figure 8-1 Configuration Dashboard 


e File Reporter Configuration Dashboard - 4.0.0 


A Database © Configured 


Database Type: SQL Server - Standard Edition (64-bit) 

Database Version: Microsoft SQL Server 2017 (RTM-GDR) (KB4505224) - 
14.0.2027.2 

Database Name: srsdb 

Database User: srsadmin 

Address: localhost:1433 

Schema Version: 4.0.0.1 


[Fs License O vaid license 
Show Details 
Es Engine © Running 


Address: 0.0.0.0:3035 

Admin Group: SP\SrsAdmins 

Proxy User: SP\SrsProxy 

Rights Group: SP\SrsProxyRights 

Engine Timezone: (UTC +00:00) Coordinated Universal Time 


Y Message Broker © connected 


AMOP Endpoint: localhost:5671 
API Endpoint: https://localhost:15671 
Service Account: srsbroker 


B Web Application O Running 


Web Site: SrsSite 

AppPool: SrsAppPool 

AppPool Identity: SP\SrsAppPoolSvc 
Disk Path: C:\inetpub\srs_root\ 
Https Listeners: [All IP Addresses]:443 
Hostname: filereporter.sp.cctec.org 
AppPool Recycle Time: 03:00:00 


https://filereporter.sp.cctec.or 


@ Active Directory forest ‘sp.cctec.org’ available - joined to domain SP 


Configure Database 


Install or Update License 


Configure Engine 
Stop Engine 
Stop Scan Processor 


Configure Message Broker 


Configure Web Application 
Stop Web Service 

Stop Web Site 

Stop Application Pool 


G Refresh 


8.2 Using Folder Summary 


The Folder Summary feature provides you a visual folder structure according to the latest scanned 
file system data. Folder Summary also provides extensive summary information for the folders and 


files. 


You can access Folder Summary by selecting Reports > Folder Summary. 
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Figure 8-2 Folder Summary 


Path ‘Seam Srart Time Fite Se FieCourt Felder Count Felder Ouers X of Parent Folder Sire E of Teen Sine 


You can print, save, or export the data as a PDF or XLS file. 


8.3 Considerations for Reporting on NAS Devices 


File Reporter can report on the contents of Network Attached Storage (NAS) devices. Integration 
information for reporting on specific NAS device types is found below. 

+ Section 8.3.1, “NetApp filer,” on page 119 

+ Section 8.3.2, “EMC Isilon,” on page 120 

+ Section 8.3.3, “Other NAS Devices,” on page 120 


8.3.1 NetApp filer 


For a NetApp filer device, configuration is very simple because the device does not fully emulate a 
Windows Server at the operating system level. 


1 Use the NetApp filer administration utility to join the NAS device to a domain where File 
Reporter can report. 
2 Grant the proxy rights group membership in the NAS device's built-in Administrators group. 


3 Grant the proxy rights group the folder share permissions that are required to access the 
storage. 


There are no LSA rights and privileges to grant on a NetApp filer NAS device. 
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8.3.2 


8.3.3 


120 


8.4 


EMC Isilon 


Perform the following steps to integrate an EMC Isilon device. You can use these same steps to see if 
other NAS devices integrate with File Reporter. 
1 Rebuild the storage resources and verify that the NAS device is displayed on the list. 


2 Perform any needed steps for giving the proxy rights group access to the desired shares and 
folders on the NAS device. 


Other NAS Devices 


Perform the following steps to see if other NAS devices integrate with File Reporter. 


1 In the associated Computer object in Active Directory, add the following text somewhere in the 
description attribute for that object: 


***SRGenericNASDevice*** 
2 Rebuild the storage resources and verify that the NAS device is displayed on the list. 


3 Perform any needed steps for giving the proxy rights group access to the desired shares and 
folders on the NAS device. 


Changing the Default Path for Stored Reports 


The default path for stored reports is established during the installation of the Engine. If you want to 
change the file path, you can do so if the new path is on the server hosting the Engine and Web 
application. 


Because both the Web application and the Engine via the Stored Reports DLL need access to the 
report files, the service accounts those processes run as must have both Read and Write access to 
the specified path. For the Engine, this is the Windows Proxy Account and for the Web Application, 
this is the associated IIS AppPool Identity, which is a hidden account created by Windows and tied to 
the Application Pool when the Web service was configured. 


If you create a new folder for the stored reports, you must assign Read and Write access for the 
associated Windows server/proxy account to that folder, as well as the AppPool Identity. Because 
you cannot browse for the AppPool Identity, you need to use the name of the AppPool itself: 


Performing Other Administrative Tasks 


8.5 


8.6 


Select Users, Computers, Service Accounts, or Groups X 


Select this object type: 

Users, Groups, or Builtin security principals Object Types... 
From this location: 

dynamics.cctec.org Locations... 


Enter the object names to select (examples): 
SrsAppPoolSvc Check Names 


File Reporter does not move previously generated reports to the new location. 


1 Select Configuration > Stored Reports. 


2 Inthe Stored Reports Folder field, specify a new path. 
3 Click Save Changes. 


Changing the Life Span of Stored Reports 


By default, stored reports are available for access for 30 days. You can adjust this setting by following 
the procedures below. 


NOTE: You can always save a Preview or Stored report locally so it remains accessible indefinitely. 


1 Select Configuration > Stored Reports. 
2 In the Default Expiration field, adjust the setting. 
3 Click Save Changes. 


Resetting the Proxy User Password 


If the proxy user password is not working, you can reset it through the Engine Configuration Utility. 
As part of the configuration process, it resets the proxy user password. 
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9.1 


Using the Report Viewer 


NOTE: The Report Viewer is installed as a separate application, rather than part of the Client Tools. 
This is so both administrators and other users who need access to the reports can access saved 
reports. 


Use the Report Viewer 


The Report Viewer lets you to view all stored reports locally from a Windows workstation. Because 
the Report Viewer utilizes the resources of the Windows workstation, rather than those of the 
Engine, the Report Viewer can display stored reports much faster in most instances. 


In comparison to the viewing capabilities of the browser-based administrative interface, the Report 
Viewer offers more capabilities. For example, with the Report Viewer you can change the visual 
display parameters of the report. 


1 Launch the File Reporter File Viewer application. 


[El Print Preview 
m z 7 r ; R a o € x 
=] tee | | -— DE) Jak l l b b es El J) =n 
/ IA - 
E me nia Una 


Open Save Print Quick Find Bookmarks First Pi 


Q revious Las O oom Zoo g 
Print Page Page Page Page ` To 


Document Print Navigation Zoom Page Background Exp... 


Nothing 


2 Click Open, browse to the location of your stored reports, then click Open. 


To determine where stored reports are located, in the File Reporter administrative interface, 
select Configuration > Stored Reports and view the location in the Stored Reports Folder field. 
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Print Preview 


J a) / y m o o a e A] D Ey 
= | = 
-N wee wed Per qee 
Open Save Print Quick Find Bookmarks First Previous Next Last ba Many Pages Zoom Out Zoom Zoomin Page Color Watermark Export 
Print Page Page Page Page A v ¥ v To Y 


Document Print Navigation Zoom Page Background Exp... 


Document Map 


v Owner 
> Parameters 
Top Ten Owners by File Size 
> Report Data 


Owner Report 


CCTEC 


CCTEC 


Report Date: 11/30/2020 8:54:32 PM 
Generated by: File Reporter 


3 (Optional) Adjust the view to your preferences using the tools discussed below. 


Bookmarks: Click to toggle between the report Document Map being displayed and not 
displayed. 


Many Pages: Click to specify the number of pages you want displayed. 

Zoom Out: Click to see more of the report page at a reduced size. 

Zoom: Click to change the zoom level of the report preview. 

Zoom In: Click to get a close-up view of the report. 

Page Color: Click to change the color for the background of the report pages. 


Watermark: Click to insert a ghosted text or image behind the content of each page of the 
report. A watermark is often used to indicate how a document is to be treated specifically. 


The Watermark dialog box lets you specify your watermark settings. Your watermark can either 
be in text or graphic form. 
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Watermark 


Text Watermark | Picture Watermark 


Text: DO NOT COPY 


Direction: |Forward Diagonal 


Font: Verdana 


Y Bold 


Transparency (0-255): 
A A 


Position Page Range 
In front © All Pages: 


® Behind Enter page numbers and/or page ranges 
z separated by commas. For example: 1,3,5-12 


Cancel 


4 (Optional) Save the Report using the tools discussed below. 


Save: Click to save the report. The report is saved as a .PNRX file, meaning that in this format, 
the report can only be opened through the Report Viewer. 


Export To: Click to export the report to a new format. Each selected format option brings up a 
dialog box where you can provide specifics on how you want the report exported. 


XLSX Export Options 


Text export mode: | Value 


Show grid lines 
V] Export hyperlinks 
| Raw data mode 
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10.1 


Using the Data Analytics Tools 


The Micro Focus File Reporter Client Tools are designed to provide members of the administrators 
group expanded abilities in analyzing data and designing reports. The Client Tools are run from a 
Windows workstation. 


The analytics tools are an integrated set of data visualization applications that include a Dashboard, 
Pivot Grid, and Tree Map. 


The Report Designer allows you to design reports locally from a Windows workstation while offering 
significantly more reporting design capabilities to those of the browser-based administrative 
interface. 

¢ Section 10.1, “Launching the Analytics Tools,” on page 127 

¢ Section 10.2, “Using the Dashboard,” on page 129 

+ Section 10.3, “Using the Tree Map,” on page 131 

+ Section 10.4, “Using the Pivot Grid,” on page 132 


Launching the Analytics Tools 


These procedures briefly introduce you to some of the capabilities of each of the applications. You 
will discover more capabilities as you work with each of the applications on your own. 
1 From the Start menu, select File Reporter 4.0 Data Analytics. 
The following login screen appears: 


2 Enter your login credentials and click Login. 


Login x 


Web Service URI |https://filereporter.sp.cctec.org/ 
User Name sp\administrator 


Password eoccccccccs| 


A selection dialog box similar to the following appears: 
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O 


Logout 


Load from Database 


Database Connection 


3 Expand the shares and volumes. 


a | Network Path 


Server a 


riv Server: srs-m1.sp.cctec.org 
sp.cctec.org 
sp.cctec.org 
sp.cctec.org 
sp.cctec.org 
sp.cctec.org 


\\srs-m1.sp.cctec.org\refs-share 
\\srs-m1.sp.cctec.org\Shares 
\\srs-m1.sp.cctec.org\Shares 
\\srs-m1.sp.cctec.org\Shares2 
\\srs-m1.sp.cctec.org\Shares2 


4 Double-click the File System scan you want to analyze. 


The data from the scan is presented in the Dashboard. 


Identity System a | Network Path a | 
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Filters dy Summary Data 
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| 
| 
| 
| 
| 
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File Extensions Ta 
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Files Created by Year 


W T 9 55 Top Extensions by Size 


Size (Sum) 
2 RRR RRR RR ER 


e ae docx 


W Tits Files Modified by Year 


(anoo) ams 


o 
Summary oi | 
Owners 
625 
File Extensions 
30 
Files 
1K 
Total Bytes 
1.5M 


OTIS 
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Using the Dashboard 


NOTE: The exercises in the remainder of this chapter introduces you to some of the very basic 


analytical features of the Analytics Tools. Through familiarizing yourself with these basic features, 


you will become proficient enough with these tools to try more advanced features. 


In the Filters region of the Dashboard, deselect one or two of the check boxes and observe how 
the changes are reflected in the Summary Data, Top Extensions by Size, and Summary regions of 
the Dashboard. 


In the Files Created by Year region, click a specific year. 


Observe the changes in the Summary Data, Top Extensions by Size, and Summary regions of the 
Dashboard. 


The graphical displays in the Summary Data, Top Extensions by Size, and Summary regions of the 
Dashboard are driven by the Filters region and the selected years from the Files Created by Year 
and Files Modified by Year regions. 


In the Summary Data region, place the cursor over a pie graph section and observe how 
sectional-specific information appears in a balloon. 


Double-click the pie graph section and observe how the Dashboard drills down to show data 
specific to the selected section in the Summary Data, Top Extensions by Size, and Summary 
regions. 


Right-click a section of the new pie graph and select Details Grid to view the individual 
filenames. 


= & GE 
Open Folder Export Export 
to Excel to CSV 
A 
Drag a column header here to group by that column yo) 
Full Path Name File Name E... | Size Owner Create Time |Modify Time | Access Time Index Parent Index |Path Depth | Path Type |Scan ID 
a FutureFile.... txt 48 bytes BUILTIN\Ad... 9/21/2020... 9/21/2020... 9/21/2020... 6 5 2 File 241 ^ 
\ 3 file-dates.zip zip 374 bytes BUILTIN\Ad.., 9/21/2020... 9/21/2020... 9/21/2020... z 5 2 File 241 
Wisrs-m1.sp... modifiedb... txt O bytes BUILTINAd... 9/21/2020... 9/21/2019... 9/21/2019... 8 5 2 File 241 
\\srs-m1.sp... us-ssn.txt bd 36 bytes BUILTIN\Ad... 9/11/2024... 9/21/2023... 2/11/2020... 9 5 2 File 241 
\\srs-m1.sp... SOLDumpe... exe 153 KB BUILTIN\Ad... 9/21/2020... 10/4/2019... 9/21/2020... 19 12 5 File 241 
\\srs-m1.sp... as80.xsl xsl 17 KB BUILTIN\Ad... 9/21/2020... 6/3/2019 1... 9/21/2020... 22 21 6 File 241 
\\srs-m1.sp... as90,xsl xsl 20KB BUILTIN\Ad... 9/21/2020... 6/3/2019 1... 9/21/2020... 23 21 6 File 241 
\\srs-m1.sp... db2v0801.xs! xsl 30 KB BUILTIN\Ad.., 9/21/2020... 6/3/2019 1... 9/21/2020... 24 21 6 File 241 
\\srs-m1.sp... hive.xsl xsl 80KB BUILTIN\Ad... 9/21/2020... 6/3/2019 1... 9/21/2020... 25 21 6 File 241 
\\srs-m1.5p... msjet.xsl xsl 30 KB BUILTIN\Ad... 9/21/2020... 6/3/2019 1... 9/21/2020... 26 21 6 File 241 
\\srs-m1.sp... Informix.xsl xsl 31 KB BUILTIN\Ad... 9/21/2020... 6/3/2019 1... 9/21/2020... 27 21 6 File 241 
\\srs-m1.sp...  msql.xs! xsl 126 KB BUILTIN\Ad... 9/21/2020... 6/3/2019 1... 9/21/2020... 28 21 6 File 241 
\\srs-m1.sp... orcl7.xsl xsl 94KB BUILTIN\Ad... 9/21/2020... 10/4/2019... 9/21/2020... 29 21 6 File 241 
\\srs-m1.sp... 5q1120,xs! xsl 132 KB BUILTIN\Ad... 9/21/2020... 10/4/2019... 9/21/2020... 30 21 6 File 241 
\\srs-m1.sp... sql2000.xsI xsl 34 KB BUILTIN\Ad... 9/21/2020... 6/3/2019 1... 9/21/2020... 31 21 6 File 241 
\\srs-m1.sp...  sql70.xsl xsl 32 KB BUILTIN\Ad... 9/21/2020... 6/3/2019 1... 9/21/2020... 32 21 6 File 241 
\\srs-m1.sp... sql90.xsl xsl 133 KB BUILTIN\Ad... 9/21/2020... 6/3/2019 1... 9/21/2020... 33 21 6 File 241 
\\srs-m1.sp... sqipdw.xsl xsl 103 KB BUILTIN\Ad... 9/21/2020... 6/3/2019 1... 9/21/2020... 34 21 6 File 241 
\\srs-m1.sp... Sybase.xsl xsl 30KB BUILTIN\Ad... 9/21/2020... 6/3/2019 1... 9/21/2020... 35 21 6 File 241 
Wisrs-m1.sp... trdtv2r41.xsi xsl 103 KB BUILTIN\Ad... 9/21/2020... 10/4/2019... 9/21/2020... 36 21 6 File 241 
Wsrs-m1.sp... msmdsrvi.ril ril 1MB BUILTIN\Ad... 9/21/2020... 10/4/2019... 9/21/2020... 40 38 7 File 241 = 


7 From the grid, right-click a file and select Open Folder to open the folder where the file is 


located. 
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The Dashboard gives you the ability to easily access any files you might want to know about. 
8 Close the grid. 


9 Drill up to the originally displayed data by clicking the Drill Up arrow pertaining to the Summary 
Data region of the Dashboard. 


10 In the Top Extensions by Size region, place the cursor over one of the bars and observe how 
sectional-specific information appears in a balloon. 


11 In the Top Extensions by Size region, right-click and select Export to Image. 
12 Save the image to a location on your desktop. 


The graphic can now be used in a presentation or report. 


Top Extensions by Size 


2.1M 
1.8M 
4 
1.5M 
"A un 
N 
5 1.2M eZ 
~— Q 
N È 
in 0.9M La 
0.6M 
1 
0.3M 
0M 0 


exe config log csv bt 


13 In the Files Created by Year region, double-click a year span and observe how the displayed data 
in the other regions is updated to data pertaining to the selected year. 


14 Right-click the selected year span and select Clear Master Filter to have the graph span all of the 
years again. 


15 In the Files Modified by Year region, double-click a year span and observe the change in the 
displayed data in the Dashboard. 


16 Place the cursor over a bar in the Top Extensions by Size region, right-click and select Print 
Preview. 


17 Observe that in addition to printing, you can save the graph as a PDF or email the graph. 


18 Close the Print Preview page. 
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10.3 Using the Tree Map 


The Tree Map lets you view graphical representations of hierarchical file system data and in the 
process, gain insight very quickly. 

1 From the Dashboard, click Load from Database. 

2 Browse to select the file system scan you want and double-click it. 


3 Click Tree Map. 


o 2 E 


ap File Extension Owner Date Range 


Folders File Extension 


Properties 


4 Observe how the Tree Map is presented according to file extension type with the specific color 
assignments detailed in the File Extension region. 


Each of the squares in the Tree Map represents a single file in the scanned storage resource. The 
squares are represented according to the file size, relative to all of the other files in the scan. 


5 Click one of the larger squares to view the details of the file in the Properties region. 

6 Right-click the file and select Open Parent Folder to open the folder where the file resides. 
This gives you the ability to easily access any files you might want to know more about. 

7 Expand the file system so it is displayed in the Folders region. 

8 Click one of the folders to see the group of files that reside in that folder. 
The files belonging to a selected folder are outlined by a magenta colored outline. 


9 Right-click a folder and select Set Scope to drill down and view the contents of the folder in the 
Tree Map. 


10 In the Folders region, right click the listed scan and select Reset Root Scope. 


11 Click Owner. 
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The Tree Map now displays files according to owners. 


12 Using the color classifications in the Owner region, observe which users are storing the largest 
files. 


13 Click Date Range > Access Date. 


14 Observe how the data in the Tree Map is now classified according to when files were last 
accessed. 


This is one of the most powerful means in File Reporter of quickly determining the relevance of 
data being stored on network storage resources. 


10.4 Using the Pivot Grid 


The Pivot Grid gives you the ability to visually analyze data according to combinations of variables. 


1 From the Dashboard, click Load from Database. 
2 Browse to select the file system scan you want and double-click it. 
3 Click Pivot Grid. 


Pivot Fields 


Y la Dimensions 


Chart 


4 From the Pivot Fields region, select Size (residing in the Measures folder) and drag it up to the 
area marked Drop Data Items. 


5 Again in the Pivot Fields region, select Owner and drag and place it in the area marked Drop Row 
Fields Here. 


6 Observe the totals now calculated for the two data variables. 
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the area marked Drop Column Fields 


Here. 


From the Pivot Fields region, expand Access Time to locate Access Time (Month) and drag it up to 
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8 Click the filter icon from the Access Time (Month) filter that you just placed. 
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Values Numeric Filters 


Enter text to search... P 
[Y] (Al) 

[v] January 

v| February 

[v] June 
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Clear Filter | OK | Cancel | 


9 Deselect all but one month and OK. 
10 Click the Chart tab. 
11 Highlight three consecutive rows to view the data analyzed as graphs in the Chart region. 
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Record Count 1,134 


12 From the Chart Presets options, experiment with different chart views of the data. 


13 Double-click a selected cell from the table to access the Scan Data Details table specifying all of 
the files accessed by that user during that month. 


14 From the Scan Data Details table, right-click a file and select Open Folder to open the parent 
folder of the file. 
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15 
16 
17 
18 


With the parent folder open, you can examine the file, move it to another location, or delete it. 
Click the Reports tab. 

Again, highlight three consecutive rows. 

Click Generate Report. 


Observe that you have the option to print the report or export it to a number of different 
formats. 
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1 Using Report Designer 


11.1 


Report Designer allows you to design reports locally from a Windows workstation while offering 
significantly more reporting design capabilities to those of the browser-based administrative 
interface. 


Using the Report Designer Interface 


NOTE: You must be a member of the SrsAdmins group to design reports using Report Designer. The 
name SrsAdmins is the default name (which you can change) of the File Reporter administrators 
group created during the installation of the Engine. 


1 From the Start menu, launch the File Reporter 4.0 Report Designer. 


Login 


Web Service URI |https://filereporter.sp.cctec.org/ 
User Name sp\administrator 


Password Password 


2 Enter the login credentials and click Login. 
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E Main 


[) =x’ 


pe | ili Ci, ay 


New Custom Rename Copy Delete Refresh Edit Query Design Report Cle ort Visit Community Access Online 
Query Report Layout Portal Templates 
Manage Edit Online Resources 


Report Name Report Type 


[Unknown] 


dia File Types tom Query 


Find Acces DB Files Custom Query sp\administrator 


Home Folder Summary Custom Query sp\administrator 


[Report Type] = ‘Custom Query Edit Filter 


3 Familiarize yourself with the Report Designer interface. 


All Custom Query Reports are listed. Those that have not been designed using the Report 
Designer Layout interface are displayed with the green-bannered text icon, while those 
designed using the Report Designer have the blue notebook icon. 


All of the options on the toolbar are available by selecting a report and right-clicking. 


New Custom Query Report: Click to create a new Custom Query Report by launching the 
Query Editor. 


Rename: Click to rename a selected Custom Query Report. 

Copy: Click to create a copy of the report definition of a selected report. 
Delete: Click to delete a selected Custom Query Report. 

Refresh: Click to refresh the list of saved reports. 


Edit Query: Click to edit the SQL commands pertaining to a selected Custom Query Report 
through the Report Designer’s Query Editor. 


Design Report Layout: Launches the Report Designer Layout interface. For more information on 
the Report Designer Layout interface, see Section 11.3, “Designing a Custom Query Report,” on 
page 142. 


Clear Report Layout: Click to clear custom design settings created using the Report Designer 
Layout interface. This is a nonreversible procedure. 


Visit Community Portal: Click to access the File Query Cookbook website. 
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File Query Cookbook CHI O) 


Serving tasty file reports one query at a time! 


HOME CUSTOM 


User login 


pees’ Welcome! 


Each day we go about our business whether we create software, train a child in a school district, build planes in aerospace, 
provide healthcare, insure peoples stuff, etc. We all have data with varying degrees of importance, some highly critical to the 
business directly and some highly critical to our customers, while other data is the communication that helps our business units 
successfully work together. Each of the data types have similarities in size, age, ownership, and a level of security. 


Password * 


> Create new account 
Request new password 


Having the ability to query our data helps us to answer a number of questions: 


> Where's the data? 

em > What types of data are we maintaining? 
> Who owns the data? 

> Who has permission to access the data? 

> How fast are we using up our storage space? 

> How old is the data? 

> How often is the data being accessed? 


Privacy Policy 


Once queried the data needs to be collated into reports. These reports are read differently based on the perspective of the 
individual. A volume free space report, read by the Director of Information Technology will not be read with the same 
perspective as the Business Manager, as the former is figuring out the storage budget, while the other is wondering where the 
all the current data is. Reports may need to be laid out differently in order to drive the business intelligence needed, based on 
perspective. 


This site attempts to help you learn how to write queries and generate report layouts to help you achieve a new level of success, 
while supporting, maintaining, and protecting your storage. 


File Query Cookbook is a community website for sharing Custom Query reports and layouts 
created through the Report Designer. You can utilize a shared Custom Query report by simply 
copying the SQL commands in a shared Custom Query report “recipe.” You can also download 
shared layouts created through the Report Designer. 


Access Online Templates: Click to directly access the list of all available Custom Query reports 
shared on the File Query Cookbook website. From the Custom Query Recipes page, you can 
filter your search by category, database host, and more. 


Filter: The cell directly below the Report Name column heading is a report filter that lists saved 
Custom Query reports according what you enter. For example, if you were to enter the word 
access, the listed Custom Query reports would be only those with the word access in the 
report name. 


[Report Type]: By default, this check box is selected so that it displays only Custom Query 
Reports, which are the only reports that can be designed using the Design Editor. You can 
deselect the check box to view all of your reports. 


Edit Filter: Use this button to further refine your filtering using Boolean operators. 


Creating a Custom Query Report 


NOTE: For details and examples of the supported database functions, tables, and views that you can 
utilize in Custom Query reports, refer to the Micro Focus File Reporter 4.0 Database Schema and 
Custom Queries Guide. 


1 Click New Custom Query Report. 
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New Custom Query 


Name | New Report 


2 Specify a descriptive name, then click Create. 


The Report Designer Query Editor is launched. 


Query Editor - Custom Permissions 


E Main 
mk - 
A > [| {Gay SQL Text Editor = ===] E 
[7] 22] Query Builder ES pa 
Save Execute __ Reset All Refresh Design 
Query Vv E Query Results Dock Panels Schema Layout 
SQL Query View Schema Options Report Designer 


SQL Query Text x 


al 


SQL Query Builder 


g| Â Main 


DE 


SQL Query Builder SQL Query Results 


Records Loaded: 0 


3 In the SQL Query Builder region, expand srs to see the Tables and Views folders. 


4 Expand either the Tables or Views folder. 


5 Expand a displayed table or view. 


6 Select the tables and fields you want included in the query by double-clicking each. 
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Query Editor - Custom Permissions 


E Main 


[2] ‘fay SQL Text Editor 


SQL Query Builder 
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SQL Query Builder SQL Query Results 


Records Loaded: 0 


> 


x a 


Main 
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Save Execute Reset All Refresh Design 
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SQL Query View Schema Options Report Designer ed 
SQL Query Text x bd 
1 ELECT pa 
2 srs.ad_objects.id, 
3 srs.current_fs_scans.scan_id, 
4 srs.current_fs_scans.scan_type, 
5 srs.current_fs_scans.progress_status 
6 FROM 
y srs.ad_objects, 
Lg La v 


{v 


Visible Expression Colu... Sort Type Sort Order Aggregate 
ad_objecteid | 
[M] | curent_fs_scans... 
M] | curent_fs_scans... 
lv] | current_fs_scans... 


E-Q Main 
i Expressions 
id (ad_objects) 
scan_id (current_fs_scans) 
scan_type (current_fs_scans) 
-- progress_status (current_fs_scans) 
Ei) Objects 
F= ad_objects (srs) 
«E%, current_fs_scans (srs) 


7 Append the query with any additional SQL commands in the text editor. 


8 Click Execute Query to get a preview of the Custom Query Report. 
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9 Click Save. 


10 Close the Query Editor. 
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11.3 Designing a Custom Query Report 


After you have created a Custom Query Report, either through the Report Designer Query Editor or 
the Query Editor built into the browser-based administration interface, you can design the layout of 
the report. 


NOTE: This exercise introduces you to some of the very basic design features of the Report Designer. 
Through familiarizing yourself with the basic features, you will become proficient enough in the 
interface to try more advanced features. 


For a more detailed explanation of features in the Report Designer, refer to: https:// 
devexpress.github.io/dotnet-eud/interface-elements-for-desktop/articles/report-designer/report- 
designer-for-winforms.html. 


1 From the listed Custom Query Reports, select the one you want to design. 


E Main 


= = A 
=|) ==" x in 25 all it En lt 
[7 P ES ¡E EA v ee EW 
New Custom Rename Copy Delete Refresh Edit Query Design Report Clear Report Visit Community Access Online 
Query Report Layout Layout Portal Templates 
Manage Edit Online Resources 
Report Name Report Type AT Report Owner Last Modified 


ae = [Unknown] ae = = 


| Find Media File Types Custom Query sp\administrator 12/3/2020 6:56:... 2 
Find Acces DB Files Custom Query sp\administrator 3 
> Home Folder Summary Custom Query sp\administrator 4 
[2] Custom Permissions Custom Query sp\administrator 12/3/2020 8:32:... 5 

v [Report Type] = ‘Custom Query’ Edit Filter 


2 Click Design Report Layout. 
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E Report Designer Print Preview 
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3 Create a report header. 
3a Place the pointer in the upper section of the layout grid. 
3b Right click and select Insert Band > Report Header. 
A new ReportHeader band appears on the grid. 
4 Resize Page 1 and add a page break. 


4a Place the pointer on the bottom border of the new band and using the vertical ruler as a 
guide, extend the band to fill the first page. 


For example, to fill the first page, you might extend the border down to the 8" mark. 
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4b From the Standard Controls region, click and drag a Page Break to the bottom of the band. 
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5 Insert and design a chart. 
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5a From the Standard Controls region, click and drag a Chart to the band. 


The Chart Designer is launched. 
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There are no visible series to represent in a chart 
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Options | Properties Date 
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Appearance Default (All Colors) 
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Back Color. ( === ) 


5b In the Chart Designer, below the Chart menu, click the + that pertains to the Series option 
and select the Bar option. 
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Chart Designer 
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Chart Designer o x 
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5c Click the Date tab and expand Query Results. 
5d Click and drag Category to the Argument cell. 


5e Click and drag cat_size to the Value cell. 


5f Click the Options tab and in the Name field, replace Series 1 with Category Size. 


5g Below the Chart menu, click the XY-Diagram option. 
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5h In the Options tab, select the Rotated check box. 


| Chart Designer g x 
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Points (0) 1 
Indicators (0) 
v dhi XY-Diagram 

> Default Pane H 
Additional Panes (0) 

> Primary AxisX 

> Primary AxisY 
Secondary X-Axes (0) 
Secondary Y-Axes (0) 

EE] Default Legend 
[=] Additional Legends (0) 
Titles (0) E 
MA Annotations (0) 


[7] Display the designer every time a new chart is added oK Cancel 


5i Below the Chart menu, select Titles, click the +, and select Title. 

5j In the Options tab, in the Lines field, replace Chart Title with a more descriptive name. 
For example, File Extensions by Category. 

5k Below the Chart menu, select Category Size. 

51 Click the Properties tab, scroll down and under the Elements heading and expand View. 


5m Change the Color Each setting to Yes. 
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Chart Designer D x 


Lele > A 
= Options | Properties | Data 
| [v ali Chart . : 
File Extensions by Category Enter text to search. 
Y all Series (1) 
Y Category Size Series Points So... Argument B 
Label 3 Show in Legend Yes 
> 
aan Top N Options _| (Top N Options) 
Value Scale Type Numerical 
Indicators (0) i i E K 
v dh XY-Diagram ZE Argument Data... Query Results.owner_n... 
> Default Pane Color Data Me... 
Additional Panes (0) H Data Source Sor... No 
> Primary AxisX Filter String 
ión > Qualitative Sum... (Qualitative Summary O... 
aan > Value Data Me... | (Collection) 
Secondary X-Axes (0) G , BG aaa x 
Secondary Y-Axes (0) > Label (Side-by-Side Bar Series... 
regate... 
Additional Legends (0) agreg 
Bar Distance 0 
v MY Titles (1) Bar Distanc... 1 
ke E sawah as 
SA Annotations @ > Border — Rectangular Bor... 
Color 
j an ts 
Colorizer 
Equal Bar... Yes 
rs > Fill Style (Rectangle Fill Style) 
> First Point (Side Point) 
> Last Point (Side Point) 
B [0.3] Pane (Default Pane) 
> Shadow (Shadow) 
Tag 
Transparency 0 
A 18.6} X-Axis Primary AxisX 
Y-Axis Primary AxisY 
0 2 4 6 8 Misc A 
| Mama Catania Siza z 
| [Z Display the designer every time a new chart is added oK | cancel 


5n Click OK. 


Œ- Report Designer Print Preview 


i BT Xib nN m ES EE Ae > 


Q zoom ~ 
Open... Save Refresh Data Download Edt Query Cut Copy Paste Undo Redo 3 FA Layout Windows — Scripts 
= o Aa s B I: UWZ an EIN ne isan S 
Report Report Data Edt Font Alignment Zoom View Scripts Eby 
Toolbox + Field List o 3 
= 5o L E : L - : m v ER Report Data 
[4 Check Box O > EE Query Rets 


E Roch Text 


, . a. 
File Extensions by Cate... 


Miss M32 
s Ms m 
Breust [Y Report Explorer 
Properties a oe 
bd 0 s 
J x la chart) Chart 
Seek 
‘ < 
‘ I » Appearance. Default 
Group and Sort ce M a e Ø- 
> Backgroun.. (Background image) & 
j Adda Group? % AddaSot+ X Delet Move U; Move Down 
A = m heed de eo 
Fresa Name Sort Order Show Meader Show Footer 
Border Das. . 
Boraer wan $ 1 
Table of Contents 
El maansa E Groupandsot LO Scripts Errors Gets or sets the chart controls backgrou. 
harti { Location:S3, 115 Size-300,200 ) Record Count O dl Partisi query resulte in ute 100% -——t + 


50 In the upper right-hand corner of the newly-placed chart, click the arrow to access the 
Chart Tasks menu and select Run Designer. 


5p Click the legend and from the Options tab, deselect the Visibility check box so the legend 
no longer appears. 
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5q Click OK. 
5r In the Report Designer, expand the view of the chart to take up more of the page. 


6 Insert labels. 
6a From the Toolbox, click and drag Label to a position centered below the chart. 


Toolbox EA a 


v TT rep 


1 Date 
> FEE Query Results 


Es nera ty Report Explorer 
Properties 
labeli Label 


noz 


Group and Sort 


Mi Adáa Group» % Adda Son” 


6b Double-click within the label and specify the label name. 
For example, Total Size. 
6c Adjust the font size and style to your preferences. 
7 Create new fields. 
7a Fromthe Field List, expand the Query Results. 
7b Right-click Query Results and select Add Calculated Field. 


7c In the Design region of the Property Grid for claculatedField1, change the (Name) 
setting to cfTotalSize. 


7d While still in the Property Grid, under the Data heading, click the ellipses (...) pertaining to 
the Expression field. 
This launches the Expression Editor. 

7e Inthe bottom-left column, select Functions. 


7f In the empty field at the top of the middle column, type sum to locate the Sum function, 
then double click Sum to place the function in the top text box of the Expression Editor. 


> 


7g Inthe bottom-left column, select Fields and then in the middle column, double-click 
cat_size. 
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Fields 

Report Items 

Constants 

Operators 

4 Functions 

Aggregate 
Date Time 
Logical 
Math 


Strina 


Expression Editor 


Sum([cat_size]) 


4 fed Query Results 


[13] cat_size 


ab 


FR 
ab 


123 


cat_size_string 
category 
file_count 


A|| The type of this field is: 
System.Int64 


OK Cancel 


7h Click OK to save the new filed and close the Expression Editor. 


Ji 


7j In the Design region of the Property Grid for claculatedField1, change the (Name) 


setting to cfTotalSize_String. 


Right-click Query Results and select Add Calculated Field. 


7k While still in the Property Grid, under the Data heading, click the ellipses (...) pertaining to 


the Expression field. 


7 


7m From the middle column, double-click cfTotalSize that you created earlier and click OK. 


8 Place the new fields. 


In the top text box of the Expression Editor, type Byte so that ByteString() appears. 


8a From the Field List, hold down the Control key, select the two new fields you just created, 


then drag them to the Total Size label on the grid. 


8b Adjust the size so that both fields will appear to the right of the Total Size label. 
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Custom Permissions * 


Total Size [cfTotalSize_StringH [cfTotalSize] 8 


8c Adjust the font size and style to your preferences. 
9 Preview the report. 
9a Click Download All Data. 
9b When the warning dialog box appears, click Yes. 
9c Click the Print Preview tab to observe how the report is going to look at this point. 
9d Make any desired format changes. 


10 Create a header for Page 2. 
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10a 
10b 


10c 
10d 
10e 


10f 
108 
10h 
10i 
10j 


Click the Report Designer tab. 


In the Report Designer, scroll down below the page break so that you are working on Page 
2 of the report. 


At the top of the page, right-click and select Insert Band > PageHeader. 
From the Tool Box, click and drag a Table to the location of the new page header. 
Replace the names of the three new table cells with the following names: 
+ Category 
+ Size 
+ File Count 
Select the File Count cell, right-click, then select Insert > Column to Right. 
Change the table cellname to Percent of Total. 
Resize the table cells to your preferred width. 
Adjust the font size and style to your preferences. 


Resize the depth of the page header so it is limited to the depth of the table. 
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11 Create a new calculated field for Percent of Total. 


11a 
11b 


11c 


11d 
11e 
11f 


Right-click Query Results and select Add Calculated Field. 


In the Design region of the Property Grid for claculatedField1, change the (Name) 
setting to cfPercentofTotal. 


While still in the Property Grid, under the Data heading, click the ellipses (...) pertaining to 
the Expression field. 


From the middle column of the Expression Editor, double-click cat_string. 
Hit the space bar and then enter the following string: * /100 


Complete the string by double-clicking cfTotalSize from the middle column of the 
Expression Editor. 


Expression Editor Ea 


[cat_size] * 100/[ctTotalSize] 


Fields A || Enter text to searc A|| The type of this field is: 
Report Items 4 E Query Results System.Object 
Constants [123] cat_size 
Morais ab] cat_size_string 
4 Functions E category 
Aggregate f] cfTotalSize_String 
DateTime f] ctTotalSize 
Logical [123] file_count 
Math 
Strina y 


OK Cancel 


11g Click OK. 


12 Insert the table content. 


12a Click below the header, hold down the Control key, and from the Field List, select the 


following fields in this order: 
+ category 
+ cat_size_string 
+ file count 
+ cfPercentofTotal 


12b Drag the fields to a location below the header. 
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12c Line up the tables cells with the headings. 


aa : 
A ls] l — 
a E MM & mao A Fea Bg ¢ y 
Open Save Refresh Data Download Edit Query Und ° BI A ` Jove Senpts 
sing) Dat. . A 
Report Report Data Edit Font lignment Zoom View Scripts 
Toolbox Field List 


> HG 
> E Query Results 


Total Size [lefTotalSize_SuingW/[efToralSize] G 


Category Sue File Count Percent of Total 


[category] {cat_nze_sting) |(fi3e_count] [cfPercentofTotal) 


Group and Sort 


| NOMLES/HADADA>» | 


12d Click the Print Preview tab to view how the report will look. 
12e Make any needed adjustments. 
13 Click Save > Save to Database. 


By saving the report to the database you enable the File Reporter Report Generator to use the 
report design for updated reports. 


In addition to saving the report to the database, you can save the report as a file where you can 
import it into another file, such as a Word file or PowerPoint presentation. 


11.4 Saving the Layout as a Template 


When working with the Report Designer, you might create a layout design that you want to utilize as 
a template for future Custom Query Reports. You can do so using Save As File. 


1 In Report Designer, open the Custom Query Report whose design you want to save as a 
template. 


2 Select Save > Save As File. 
3 Name and save the layout. 


The layout is saved as a .repx (Report Layout XML) file. 


11.5 Using a Saved Template for Custom Query Reports 


You can use saved , repx files as design templates for Custom Query Reports. 
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TIP: You can also use the sample report layouts and SQL commands that are available from the File 
Query Cookbook, the collaborative community portal for accessing and sharing Custom Query 
reports. Both the SQL commands and report layouts can be customized as needed. You can access 
the File Query Cookbook directly through the Report Designer interface, or at http:// 
www.filequerycookbook.com (https://www.filequerycookbook.com). 


1 In Report Designer, open the Custom Query Report you want to design using a saved template. 
2 Click Open, then select the . repx file you want to use for designing your report. 


The report is updated with the design from the . repx file. 
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A.1 


Filtering for Built-in Reports 


+ 


+ 


+ 


Section A.1, “Filters Tab,” on page 155 
Section A.2, “Single Entry Filter Conditions,” on page 157 
Section A.3, “Multi-Condition Filtering,” on page 159 


Micro Focus File Reporter enables you to utilize advanced filtering capabilities so that your reports 


include only the data you want. File Reporter provides this advanced filtering capability for all File 


Data Reports, which include: 


+ 


+ 


+ 


+ 


Filename Extension Reports 
Filename Extension Detail Reports 
Owner Reports 

Owner Detail Reports 

Duplicate File Reports 

Duplicate File Detail Reports 
Date-Age Reports 

Date-Age Detail Reports 


Filters Tab 


+ 


+ 


Section A.1.1, “Filter Expression Builder,” on page 156 


Section A.1.2, “Relative Date Filtering Parameters,” on page 157 


All filtering takes place in the Filters tab of the Report Definition Editor. 
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Figure A-1 Filters Tab 


Report Definition Editor - Atlanta Users Owner Report 


Name:* Atlanta Users Owner Report 


Unformatted: O 
Type Owner Report 


Description: Report Definition created on 12/7/2020 7:46:06 
PM by SP\Administrator 


TARGET PATHS FILE MANAGEMENT POLICIES FILTERS 


<= And 


RELATIVE DATE 


You set filter parameters using the Boolean operators available through the And drop-down menu, 
and adding the search parameters with the+ button. Alternatively, you set date filters using the 
Relative Date filter parameters on the right-hand portion of the page. 


You can filter according to size, dates, or both. 


A.1.1 Filter Expression Builder 


The And drop-down menu is used to: 


+ Select Boolean operators for creating a search filter 
+ Create additional groups or conditions 


+ Delete search filters, groups, or conditions 
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A.1.2 


A.2 


A.2.1 


Figure A-2 And Drop-Down Menu 


And 
@® And 

@ Or 

@ Not And 

@ Not Or 

=* Add Group 

= Add Condition 


X Remove 


The + button next to the And drop-down menu are used to create parameters for a search condition. 


Figure A-3 Parameters for Filter 


File Extension Begins with enter a value 


Relative Date Filtering Parameters 


Click Relative Date and then select the Create Date, Modify Date, and Access Date check boxes to 
enable the corresponding drop-down menus and fields. 


Figure A-4 Relative Date Filtering Parameters 


EXPRESSION 


A 
e e Since v v Da hi 
RELATIVE DATE 
N e Since v $ Da v 
Acebate Sioe ~ $ Days v 


Single Entry Filter Conditions 


+ Section A.2.1, “Using the Filter Expression Builder,” on page 157 
¢ Section A.2.2, “Using the Relative Date Filtering Settings,” on page 159 


You can use either the And drop-menu and + button, or the Relative Date filtering settings to create 
single entry filter conditions. 


Using the Filter Expression Builder 


1 From the And drop-down menu, select a Boolean operator. 
2 Click the + button to add an entry. 


3 From the File Extension drop-down menu, select a Boolean operator. 
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EXPRESSION 
And 


RAEE File Extension Begins with <enter a value> 
File Extension 

File Size 

Create Time 


Modify Time 


Access Time 


$ 


4 From the Equals drop-down menu, select a Boolean operator. 


EXPRESSION 
And € 


ae Access Time Equals <enter a value> 


= Equals 
Does not equal 


Á 
> Is greater than 
> 


Is greater than or y 


Is less than 


< 
< Is less than or equal to 
Es |s between 

2 


Is not between 
eee Is any of 
eee |s none of 


Date and time operators > 


5 In the <enter a value> field, enter a value. 


And 


ee Access Time ls greater than 


JANUARY 2021 


SUN MON TUE WED THU FRI SAT 


53 27 1 2 
01 3 4 5 6 7 8 9 
2 10 11 12 © 14 15 16 
o 17 #18 19 20 21 22 «23 
o 24 25 26 27 28 29 30 


os 31 


TODAY CLEAR 
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File size values must be entered in bytes. For example, if your filtering parameters were for all 
files larger than 500 MB, you would enter 524288000 (500 x 1024 x1024). A more practical 
entry might be 500000000. Do not attempt to enter commas; they are placed automatically. 


6 Click OK to save the settings in the Report Definition Editor. 


Using the settings in this procedure as an example, when you generate a report, the data would 
include only files that have been accessed after May 17, 2017. 


A.2.2 Using the Relative Date Filtering Settings 


From the Filters tab, click the Relative Date option. 
Select from the Create Date, Modify Date, or Access Date check boxes. 
From the first drop-down menu, select either Since or Before. 


From the numeric field to the right, enter a numeric setting. 


uu bb Y N PR 


From the drop-down menu to the right, select from the options. 


A 
Access Date Since v 7 $ Days v ago 


6 Click Save to save the settings in the Report Definition Editor. 


Using the setting in this procedure as an example, when you generate a report, the data would 
include only files that have been accessed in the last week. 


A.3 Multi-Condition Filtering 


You can set multi-conditioned filters by: 


+ Entering parameters for more than one entry using the And drop-down menu 
+ Specifying multiple Relative Date filtering settings 


+ Combining parameters specified through the And drop-down menu and the Relative Date 
filtering settings 


IMPORTANT: Be aware that when you set multiple entries in a condition for filtering, that all 
entries must be met in order for File Reporter to report on the file. 


For example, in the example below, the files would appear in the report only if they were 
greater than 500 MB and had been accessed after April 1, 2012. 


EXPRESSION 
And 


Se Ae Are FileSize ls greater than 524,288,000 


Access Time Isgreaterthan 4/1/2016 
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B.1 


B.1.1 


B.2 


Security Settings 


+ Section B.1, “Rights and Privileges on Scanned Storage,” on page 161 

+ Section B.2, “Firewall Requirements,” on page 161 

+ Section B.3, “Local Security Authority Rights and Privileges,” on page 162 
+ Section B.4, “Proxy Rights Group,” on page 163 

+ Section B.5, “Windows Clustering through Proxy Agents,” on page 163 


Rights and Privileges on Scanned Storage 


Micro Focus File Reporter must have the proper rights set on each network share that it scans. In 
addition, certain privileges must be granted to File Reporter on the machine hosting the Engine and 
on each server where storage is managed. 


Granting Rights 


Every Windows network share to be scanned by File Reporter must have proper rights assigned to 
the File Reporter proxy rights group. 


1 Asan Active Directory domain administrator, authenticate to the server where the storage is 
located. 


2 Grant Read Only sharing privileges to the proxy rights group for each share that File Reporter 
will scan. 


Firewall Requirements 


Depending on the host system, exceptions must be added to the firewall rules for that host. The 
following are needed for successful operation of File Reporter tasks. 


NOTE: Inbound firewall exceptions for File Reporter components installed on Windows are set up 
automatically during configuration of each component. 


+ The Engine must remain permitted to make outbound connections. 
+ The Engine must remain able to listen on port 3035. 
This is the default port choice that is presented during the installation and configuration. 
+ AgentFS must be permitted to make outbound connections. 
+ AgentFS must remain able to listen on TCP port 3037. 
This is the default port choice that is presented during the installation and configuration. 


+ The Web Application hosted on IIS must be allowed to listen on TCP ports 80 and 443. 
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B.3 


+ On each server hosting storage that you wish to collect quota via proxy, you must enable the 
Remote File Server Resource Manager Management - FSRM Service (RPC-In) firewall rule. 


+ If File Content Analysis is enabled: 


+ 


+ 


+ 


ManagerFC must remain permitted to make outbound connections. 
AgentFC must remain permitted to make outbound connections. 
RabbitMQ must remain permitted to make outbound connections. 


RabbitMQ must remain permitted to listen on TCP port 15671 for the management 
interface. 


This is the default port that RabbitMQ is configured for with TLS. 
RabbitMQ must remain permitted to listen on TCP port 5671. 
This is the default port that RabbitMQ is configured for with TLS. 


Local Security Authority Rights and Privileges 


Local Security Authority (LSA) rights and privileges are assigned to accounts or groups, and they 
determine how those accounts or group members may access the system. The rights and privileges 
are modified through secpol.msc or Local Security Policy from: 


Start > Administrative Tools > Local Security Policy 


1 In Local Security Policy, go to the following: 


Security Settings > Local Policies > User Rights Assignments 


2 Inthetable of Privileges and the objects to which they apply located on the right, verify that the 
File Reporter proxy rights group has the following privileges: 


+ 


+ 


+ 


Access this computer from the network 
Back up files and directories 

Bypass traverse checking 

Create a token object 

Create symbolic links 

Impersonate a client after authentication 
Log on as a batch job 


Manage auditing and security log 


IMPORTANT: Absence of some of these privileges causes the Engine and Agent components to not 
function properly. Removal of these rights and privileges via Group Policy Object (GPO) results in the 
Engine and Agent not functioning properly. 


If GPO conflicts are detected, set up an additional GPO with just the privileges listed above and 
assign it to the proxy rights group for the appropriate servers. 
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B.4 


B.5 


Proxy Rights Group 


By default, whenever any of the components of File Reporter are installed on a server in a domain, 
the proxy rights universal security group is granted membership in that server’s built-in 
Administrators security group. This grants File Reporter certain permissions needed in addition to 
the LSA privileges required for successful scanning of file system metadata. 


On other servers in the domain that are hosting storage to be scanned by File Reporter through a 
proxy agent, you must also grant the proxy rights group membership in the built-in Administrators 
group. This is necessary because there are many actions performed that require membership in this 
group regardless of the LSA privileges that the user has been granted—in particular, reading 
directory quotas. 


Additionally, the other servers in the domain that are not hosting components, but are hosting 
storage to be scanned, must have the necessary rights and privileges, along with some file share and 
NTFS permissions. The easiest way of granting these rights and privileges is through Group Policy 
objects in Active Directory. 


As explained previously, at a minimum, you must grant Read Only sharing and security privileges to 
the proxy rights group for each share that File Reporter will scan. 


IMPORTANT: The proxy rights group for Active Directory must be a member of the built-in 
Administrators group on each Windows server that File Reporter scans. 


Certain functions, such as collection of quotas via FSRM (File Server Resource Manager) do not work 
without this membership despite the assignment of other rights and privileges. 


Windows Clustering through Proxy Agents 


File Reporter supports clustering of Windows Server through Proxy Agents. Configuring a cluster to 
be scanned through a proxy agent is similar to configuring an individual server to be scanned by a 
proxy agent. In particular, the File Reporter proxy rights group must be granted membership in the 
built-in Administrators group and it must also be granted all of the LSA rights and privileges that are 
granted at each cluster node. When this is done, the folder share permissions and NTFS permissions 
that are required must be granted to the proxy rights group for all shares and NTFS volumes that will 
be scanned by File Reporter. 
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Log File Locations 


When troubleshooting Micro Focus File Reporter, you might need to refer to component log files. 


The locations for each are specified in the table below. 


Table C-1 Log File Locations 


Component 
Engine 

Scan Processor 
AgentFS 

Web Application 
ManagerFC 
AgentFC 


Agent365 


Typical Log File Path 


C:\ProgramData\Micro Focus\SRS\Engine\log\srsengine. log 
C:\ProgramData\Micro Focus\SRS\Engine\log\scanprocessor .log 
C:\ProgramData\Micro Focus\SRS\AgentFS\log\SRSAgentFS. log 
C:\inetpub\srs_root\AppData\logs\webui.log 
C:\ProgramData\Micro Focus\SRS\ManagerFC\log\SRSManagerFC.1log 
C:\ProgramData\Micro Focus\SRS\AgentFC\log\SRSAgentFC.1log 
C:\ProgramData\Micro Focus\SRS\Agent365\log\SRSAgent365. log 
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D.1 


AgentFS Scan Capabilities 


+ Section D.1, “Server Platform and NAS Device Support,” on page 167 

+ Section D.2, “File System Metadata,” on page 168 

+ Section D.3, “Security Scans — Active Directory File Systems,” on page 169 
+ Section D.4, “Other Microsoft Supported Features,” on page 169 


+ Section D.5, “Current Limitations,” on page 169 


Server Platform and NAS Device Support 


The following platforms are supported as server hosts for scan targets. 


Table D-1 Supported Scan Target Hosts 
Server Platform File Reporter 4.0 
Windows Server 2008 Y 

Windows Server 2008 R2 
Windows Server 2012 
Windows Server 2012 R2 


Windows Server 2016 


€ 6 8 8 $ 


Windows Server 2019 


1. Older Windows servers including Windows 2003 or 2003 R2 might work, but are not supported. 


The following NAS devices are supported as hosts for scan targets. 
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Table D-2 Supported Scan Target NAS Hosts 


NAS Device File Reporter 4.0 
NetApp Filer with OnTAP 8.x (7 mode or Cluster mode) y 

NetApp Filer with OnTAP 9.x Y 

Isilon OneFS 7.2 ' 

Isilon OneFS 8.x Y 


1. Older versions of NetApp OnTAP and Isilon OneFS might work but are not supported. 


2. Other NAS devices not listed here might work with limited support if running a vendor 
supported version of the device and management software. 


D.2 File System Metadata 


The following table lists file system scanning capabilities of File Reporter. 


Table D-3 File System Metadata Support 


Access Time? 


Directory Quota 


Metadata Feature Windows NTFS Windows ReFS 
File Name / Extension Y Y 
File Size Y Y? 
File Sparse Size Y Y 
File Compressed Size Y x 
File Size on Disk? Y Y 
Create Time Ye YO 
Modify Time? Y Y 
Y Y 
Y x 
Y Y 


Owner 


1. File size-on-disk calculations are currently performed using an assumed 4 KB block size, except 
when using AgentFS, which attempts retrieval of the actual allocation size. 
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D.3 


D.4 


D.5 


2. Access and Modify time stamps for directories are not consistently defined across file system 
types. These time stamps should only be considered for file entries. 


3. Directory Quotas are only available on Windows 2008 R2 and later servers, and only if the File 
Server Resource Manager (FSRM) Role has been installed. 


Security Scans — Active Directory File Systems 


Table D-4 Permission Scan Capabilities for Active Directory Environments 


Windows Component Supported Notes 
Share Permissions O 
Security Descriptors Y Includes the ACLs and ACEs, owner, and all ACE and 


security descriptor flags. However, only security 
descriptors for folders are currently collected. 
Additionally, deny ACEs are not factored into calculations 
for Permission by Identity or Permission by Path reports. 


Universal Security Groups Y 

Global Security Groups Y 

Local Security Groups x The local security groups themselves are collected, but 
group memberships for local security groups are not 
currently processed. 

Nested Group Memberships Y Nested group membership is collected as a flat list of all 
intermediate and leaf groups, users, and other security 
principals. The hierarchy of group nesting is not currently 
preserved. 

Primary Groups Y 

Local Security Authority (LSA) x LSA privileges are not currently collected. 

Privileges 


Other Microsoft Supported Features 


+ Multiple domains in a single forest 


+ Distribute File System (DFS) running in domain-based mode 


Current Limitations 


The following are scan limitations of File Reporter 4.0: 


+ Microsoft Environments 


+ No scanning for workstations 
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+ No scanning for standalone servers 

+ No support for Distributed File System (DFS) in standalone mode 
+ No support for Single Label Domains 

+ No support for FAT or FAT32 file systems 


+ No support for Trusted Forests 
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Glossary 


Agent365: Agent enabled to perform scanning of data and associated permissions for Microsoft 365 
file repositories, including OneDrive for Business, SharePoint Online document libraries, and Teams 
document libraries 


AgentFC: Agent enabled to perform file content scanning. 
AgentFS: Agent enabled to perform file system scanning. 


Analytics Tools: Windows workstation application included in the Client Tools designed to analyze 
data from scans. The current Analytics Tools include the Dashboard, Pivot Grid, and Tree Map. 


Baseline Scan: A scan that you save as a reference for a comparison with another scan via a 
Historical Comparison report. You can have one File System Baseline scan and one Permissions 
Baseline scan for each storage resource. 


Built-in Reports: With the exception of Custom Query reports, all of the report types that you can 
generate through the options displayed on the Add Report Definition page. 


Current Scan: The most recent scan of a storage resource. 


Custom Query Reports: Custom reports generated through SQL commands to the database. Custom 
Query reports can be generated both from the File Reporter browser-based administrative interface 
and from the Report Designer client tool. 


Engine: The component that runs File Reporter. 
The Engine does the following: 


+ Schedules the scans that the Agents conduct 
+ Compiles scans for inclusion in a report 
+ Provides the report information to the user interface 
+ Determines that a condition has been met to start a triggered report 
+ Runs scheduled reports 
+ Monitors how many agents are online 
+ Sends notifications that File Reporter has completed a scan or generated a report 
File Content Scan: The process of scanning file content for specified patterns (e.g. U.S Social Security 


numbers, credit card numbers, etc.). File Content scans are performed by an AgentFC on a Windows 
storage device. 


Historic Comparison Report: File system or permissions reports that specify the differences 
between two similar scan types of the same target system. Historic Comparison reports can compare 
Baseline scans to Previous scans, Baseline scans to Current scans, and Previous scans to Current 
scans. 
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ManagerFC: Service that is responsible for the execution and management of file scan jobs. The 
service performs the following tasks when processing a scan job: 


+ Enumeration of files in target paths 
+ Submission of files to scan queues in the message broker based on filter criteria 


+ Processing of scan results and update of result data to the database and scan result files 


Micro Focus File Dynamics: A Windows network file management system utilizing Microsoft Active 
Directory to enacted policies. Identity-driven policies automate tasks that are traditionally done 
manually, resulting in cost savings and the assurance that tasks are being performed properly. 
Target-driven policies offer data migration, cleanup, workload, and protection from data corruption 
and downtime through nearline storage backup of high-value targets, enabling quick recovery of 
files and their associated permissions. File Reporter can output reports that can be imported into 
File Dynamics Workload policies for remediation. 


Preview Report: A report generated through the Generate Preview option. Might also be referred to 
as “viewing the report in Preview mode.” 


Previous Scan: When the Retain existing Previous scan option is selected in the Scan Policy Editor, 
the status of the Current scan becomes the Previous scan. You can then use the Previous scan as a 
reference for a Historic Comparison report. There is only one File System Previous scan and one 
Permissions Previous scan for each storage resource. 


Proxy Agent: An Agent that performs agent services on a storage resource through a proxy 
association. NAS devices and clustered systems require proxy agents. 


Proxy Target: Servers, clustered systems, and NAS devices that are not hosting an Agent but are 
being scanned through a proxy agent. 


Report: The result of a report request specified through the report definition. Reports are first 
presented on-screen in either Preview or Stored mode. You can save reports in a number of different 
formats. 


Scan: Comprehensive file information pertaining to a storage resource at a specific time. 
Information from scans is the means of generating reports. 


Scan Policy: Specifies how and where the scan is conducted. All network file system scans are 
managed through a scan policy. 


Scan Processor: Introduced in File Reporter 3.0, the Scan Processor alleviates some of the workload 
that was previously performed by the Engine. This workload includes storing the scans in the 
database and processing the scans. 


Scan Target: The storage resource on the network that can be scanned by File Reporter. 


Storage resource: A resource within the network environment that File Reporter monitors and 
reports on. A storage resource can be a Windows server share, a NAS device, or a network folder 
path. 


Stored Report: A report that is stored in the Reports folder of the Engine. By default, a stored 
report is only stored for 30 days, but this setting can be adjusted through the Stored Reports 
Configuration page. 
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Unformatted Report: Report data generated as “raw” text rather than formatted and presented in a 
formatted report. In some instances, having an unformatted report might be useful for doing 
extensive sorting and filtering of the report data through a product such as Microsoft Excel. 


Web Application: The File Reporter administrative interface that runs on top of Microsoft IIS. 
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